{"id":228753,"date":"2022-10-16T09:21:00","date_gmt":"2022-10-16T06:21:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=228753"},"modified":"2022-11-09T04:09:25","modified_gmt":"2022-11-09T01:09:25","slug":"luo-mukautettuja-metalaatikoita-wordpressin-lohkoeditorilla-gutenberg","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fi\/luo-mukautettuja-metalaatikoita-wordpressin-lohkoeditorilla-gutenberg\/","title":{"rendered":"Luo mukautettuja metalaatikoita WordPressin lohkoeditorilla (Gutenberg)"},"content":{"rendered":"\n<p>Ensimm\u00e4inen kysymys, joka sinulla saattaa olla, on &quot;miksi minun pit\u00e4isi luoda mukautettuja metalaatikoita Block Editorilla (Gutenberg)?&quot;. Voit silti ottaa metalaatikot k\u00e4ytt\u00f6\u00f6n PHP:ll\u00e4 ja lis\u00e4t\u00e4 ohjaimia lohkoon, viestiin tai jopa mukautettuun sivupalkkiin. Gutenbergiss\u00e4.<\/p>\n<p>On muutamia syit\u00e4, miksi saatat haluta tehd\u00e4 t\u00e4m\u00e4n, mukaan lukien:<\/p>\n<ul>\n<li>Joillakin lohkoilla on monimutkaisia \u200b\u200basetuksia, ja metalaatikon katseleminen muokkaustilassa saattaa helpottaa sen k\u00e4ytt\u00f6\u00e4 asiakkaalle<\/li>\n<li>Koska saatat haluta muuttaa viestin tietty\u00e4 ulkoasua, kuten otsikkoa. Voit piilottaa viestin otsikkokent\u00e4n ja korvata sen mukautetulla sis\u00e4ll\u00f6nkuvauskent\u00e4ll\u00e4 sivun yl\u00e4reunassa ja hallita kaikkea siihen liittyv\u00e4\u00e4 viestin sis\u00e4ll\u00f6nkuvausta<\/li>\n<li>Koska voit k\u00e4ytt\u00e4\u00e4 <a href=\"https:\/\/wholesomecode.ltd\/guides\/register-block-template-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">lohkomalleja<\/a> sijoittaaksesi mukautetut metalaatikot haluamaasi paikkaan, jotta ne ovat j\u00e4rkev\u00e4mpi\u00e4 kontekstissa<\/li>\n<li>Koska voit soveltaa t\u00e4t\u00e4 oppimista muihin lohkoeditorin (Gutenberg) kehitt\u00e4miseen<\/li>\n<\/ul>\n<p>T\u00e4ss\u00e4 oppaassa aiomme laajentaa sit\u00e4, mit\u00e4 olemme jo rakentaneet <a href=\"https:\/\/wholesomecode.ltd\/guides\/post-meta-fields-store-attributes-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Post Meta Fields -oppaassamme<\/a>. Voit k\u00e4ytt\u00e4\u00e4 block-attribuutteja, mutta metaruutujen luonteen vuoksi k\u00e4yt\u00e4mme t\u00e4ss\u00e4 oppaassa post-metakentti\u00e4.<\/p>\n<h2>Edellytykset<\/h2>\n<ul>\n<li>Tutustu <a href=\"https:\/\/wholesomecode.ltd\/guides\/creating-plugin-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">WordPress Gutenbergin lis\u00e4osien luomiseen<\/a><\/li>\n<li>Tutustu <a href=\"https:\/\/wholesomecode.ltd\/guides\/php-render-block-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">dynaamisiin lohkoihin ja palvelinpuolen render\u00f6intiin<\/a><\/li>\n<li>Tutustu <a href=\"https:\/\/wholesomecode.ltd\/guides\/post-meta-fields-store-attributes-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">post-metakenttien k\u00e4ytt\u00f6\u00f6n WordPress Gutenbergiss\u00e4<\/a><\/li>\n<\/ul>\n<p>Koska jatkamme <a href=\"https:\/\/wholesomecode.ltd\/guides\/post-meta-fields-store-attributes-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Post Meta Fields -opasta<\/a>, on jo k\u00e4ytt\u00e4nyt <code>register_meta<\/code>post-meta-kent\u00e4n luomiseen, varmistaen, ett\u00e4 olemme asettanut <code>show_in_rest<\/code>arvoksi tosi, ja olemme my\u00f6s m\u00e4\u00e4ritt\u00e4neet JavaScript-attribuuttimme l\u00e4hteen <code>meta<\/code>ja m\u00e4\u00e4ritt\u00e4neet metaavaimen.<\/p>\n<p>J\u00e4ljelle j\u00e4\u00e4 vain k\u00e4ytt\u00f6liittym\u00e4n toteuttaminen.<\/p>\n<p>Muokkaa <code>\/src\/edit.js<\/code>tiedostoa ja korvaa <code>@wordpress\/components<\/code>tuonti seuraavalla:<\/p>\n<pre><code>import { Panel, PanelBody, TextControl } from '@wordpress\/components';\n<\/code><\/pre>\n<p>Korvaa sitten Muokkaa koodia -lohko seuraavalla:<\/p>\n<pre><code>export default function Edit( { attributes, setAttributes }) {\n    const { blockText } = attributes;\n    return (&lt;div { ...useBlockProps() }&gt;\n            &lt;Panel&gt;\n                &lt;PanelBody\n                    title={ __( 'Example Meta Box', 'wholesome-plugin') }\n                    icon=\"admin-plugins\"\n                &gt;\n                    &lt;TextControl\n                        label={ __( 'Example Meta', 'wholesome-plugin') }\n                        help={ __( 'This is an example meta field.', 'wholesome-plugin') }\n                        onChange={ (blockText) =&gt; setAttributes( { blockText }) }\n                          value={ blockText }\n                    \/&gt;\n                &lt;\/PanelBody&gt;\n            &lt;\/Panel&gt;\n        &lt;\/div&gt;\n    );\n}\n<\/code><\/pre>\n<p>Meill\u00e4 on nyt <code>Panel<\/code>, a <code>PanelBody<\/code>ja a <code>TextControl<\/code>. Huomaa, ett\u00e4 olen lis\u00e4nnyt <code>admin-plugins<\/code>-parametrin kuvakeparametriin <code>PanelBody<\/code>pit\u00e4\u00e4kseni sen yhdenmukaisena laajennuskuvakkeen kanssa.<\/p>\n<h3>K\u00e4yt\u00e4 tyylej\u00e4<\/h3>\n<p>Korvaa SCSS <code>\/src\/editor.scss<\/code>seuraavalla:<\/p>\n<pre><code>.wp-block.wp-block-wholesomecode-wholesome-plugin {\n    color: unset;\n    background: unset;\n    padding: unset;\n\n    p {\n        all: unset;\n    }\n}\n<\/code><\/pre>\n<p>Jos k\u00e4yt\u00e4t Gutenbergiss\u00e4 luotua mukautettua metalaatikkoa, suosittelen sen sijoittamista <a href=\"https:\/\/wholesomecode.ltd\/guides\/register-block-template-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">lohkomalliin<\/a>, mutta voit lis\u00e4t\u00e4 sen tavalliseen tapaan seuraavasti:<\/p>\n<p>Gutenbergin mukautetun metalaatikon k\u00e4ytt\u00e4minen<\/p>\n<p>Kun olet luonut metalaatikon, siihen lis\u00e4tt\u00e4ville ei ole rajoituksia. Koko WordPress Gutenberg React -komponenttien kirjasto on k\u00e4ytett\u00e4viss\u00e4si sek\u00e4 laaja ulkoisten React-komponenttien kirjasto (<a href=\"https:\/\/wholesomecode.ltd\/blog\/select2-as-inspectorcontrol-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">katso artikkelini select2:n lis\u00e4\u00e4misest\u00e4 projektiisi<\/a> ).<\/p>\n<p>Seuraava esimerkki on j\u00e4\u00e4vuoren huippu siit\u00e4, mit\u00e4 voit saavuttaa:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-169030-61e7fb6b454ff.png\" alt=\"Luo mukautettuja metalaatikoita WordPressin lohkoeditorilla (Gutenberg)\" \/>Mukautettu metalaatikko lis\u00e4metakentill\u00e4<\/p>\n<p>T\u00e4m\u00e4n rakentamiseen tarvitset t\u00e4ss\u00e4 koodin:<\/p>\n<h3>Rekister\u00f6i viestimetakent\u00e4t PHP:ss\u00e4<\/h3>\n<p>Avaa laajennuksen PHP-juuritiedosto (t\u00e4ss\u00e4 tapauksessa <code>wholesome-plugin.php<\/code>) ja p\u00e4ivit\u00e4 <code>register_meta<\/code>edellisess\u00e4 oppaassa lis\u00e4\u00e4m\u00e4mme seuraavalla tavalla:<\/p>\n<pre><code>function wholesomecode_wholesome_plugin_register_post_meta() {\n    register_meta(\n        'post',\n        '_wholesomecode_wholesome_plugin_example_select',\n        [\n            'auth_callback' =&gt; '__return_true',\n            'default'       =&gt; '',\n            'show_in_rest'  =&gt; true,\n            'single'        =&gt; true,\n            'type'          =&gt; 'string',\n        ]\n    );\n\n    register_meta(\n        'post',\n        '_wholesomecode_wholesome_plugin_example_text',\n        [\n            'auth_callback' =&gt; '__return_true',\n            'default'       =&gt; '',\n            'show_in_rest'  =&gt; true,\n            'single'        =&gt; true,\n            'type'          =&gt; 'string',\n        ]\n    );\n\n    register_meta(\n        'post',\n        '_wholesomecode_wholesome_plugin_example_text_2',\n        [\n            'auth_callback' =&gt; '__return_true',\n            'default'       =&gt; '',\n            'show_in_rest'  =&gt; true,\n            'single'        =&gt; true,\n            'type'          =&gt; 'string',\n        ]\n    );\n\n    register_meta(\n        'post',\n        '_wholesomecode_wholesome_plugin_example_text_3',\n        [\n            'auth_callback' =&gt; '__return_true',\n            'default'       =&gt; '',\n            'show_in_rest'  =&gt; true,\n            'single'        =&gt; true,\n            'type'          =&gt; 'string',\n        ]\n    );\n\n    register_meta(\n        'post',\n        '_wholesomecode_wholesome_plugin_example_toggle',\n        [\n            'auth_callback' =&gt; '__return_true',\n            'default'       =&gt; false,\n            'show_in_rest'  =&gt; true,\n            'single'        =&gt; true,\n            'type'          =&gt; 'boolean',\n        ]\n    );\n}\nadd_action( 'init', 'wholesomecode_wholesome_plugin_register_post_meta' );\n<\/code><\/pre>\n<h3>P\u00e4ivit\u00e4 JavaScript-attribuutit<\/h3>\n<p>Avaa <code>\/src\/index.js<\/code>ja korvaa edellisess\u00e4 oppaassa lis\u00e4\u00e4m\u00e4mme attribuutit seuraavilla:<\/p>\n<pre><code>attributes: {\n    exampleSelect: {\n        meta: '_wholesomecode_wholesome_plugin_example_select',\n        source: 'meta',\n    },\n    exampleText: {\n        meta: '_wholesomecode_wholesome_plugin_example_text',\n        source: 'meta',\n    },\n    exampleText2: {\n        meta: '_wholesomecode_wholesome_plugin_example_text_2',\n        source: 'meta',\n    },\n    exampleText3: {\n        meta: '_wholesomecode_wholesome_plugin_example_text_3',\n        source: 'meta',\n    },\n    exampleToggle: {\n        meta: '_wholesomecode_wholesome_plugin_example_toggle',\n        source: 'meta',\n    },\n},\n<\/code><\/pre>\n<h3>Tuo komponentit<\/h3>\n<p>Muokkaa <code>\/src\/edit.js<\/code>tiedostoa ja korvaa <code>@wordpress\/components<\/code>tuonti seuraavalla:<\/p>\n<pre><code>import {\n    Panel,\n    PanelBody,\n    PanelRow,\n    SelectControl,\n    TextControl,\n    ToggleControl,\n} from '@wordpress\/components';\n<\/code><\/pre>\n<h3>P\u00e4ivit\u00e4 muokkaustapa<\/h3>\n<p>Jatka tiedoston muokkaamista <code>\/src\/edit.js<\/code>korvaamalla <code>Edit<\/code>koodilohko seuraavalla:<\/p>\n<pre><code>export default function Edit( { attributes, setAttributes }) {\n    const {\n        exampleSelect,\n        exampleText,\n        exampleText2,\n        exampleText3,\n        exampleToggle,\n    } = attributes;\n\n    return (&lt;div { ...useBlockProps() }&gt;\n            &lt;Panel&gt;\n                &lt;PanelBody\n                    title={ __( 'Example Meta Box', 'wholesome-plugin') }\n                    icon=\"admin-plugins\"\n                &gt;\n\n                        &lt;SelectControl\n                            help={ __( 'An example dropdown field.', 'wholesome-plugin') }\n                            label={ __( 'Example Select','wholesome-plugin') }\n                            onChange={ (exampleSelect) =&gt; setAttributes( { exampleSelect }) }\n                            options={ [\n                                {\n                                    label: __( 'Please Select...', 'wholesome-plugin' ),\n                                    value: '',\n                                },\n                                {\n                                    label: __( 'Option 1', 'wholesome-plugin' ),\n                                    value: 'option-1',\n                                },\n                                {\n                                    label: __( 'Option 2', 'wholesome-plugin' ),\n                                    value: 'option-2',\n                                },\n                            ] }\n                            value={ exampleSelect }\n                        \/&gt;\n\n                        &lt;TextControl\n                            help={ __( 'This is an example text field.', 'wholesome-plugin') }\n                            label={ __( 'Example Text', 'wholesome-plugin') }\n                            onChange={ (exampleText) =&gt; setAttributes( { exampleText }) }\n                            value={ exampleText }\n                        \/&gt;\n\n                    &lt;PanelRow&gt;\n                        &lt;TextControl\n                            help={ __( 'Use PanelRow to place controls inline.', 'wholesome-plugin') }\n                            label={ __( 'Example Text 2', 'wholesome-plugin') }\n                            onChange={ (exampleText2) =&gt; setAttributes( { exampleText2 }) }\n                            value={ exampleText2 }\n                        \/&gt;\n                        &lt;TextControl\n                            help={ __( 'This control is inline.', 'wholesome-plugin') }\n                            label={ __( 'Example Text 3', 'wholesome-plugin') }\n                            onChange={ (exampleText3) =&gt; setAttributes( { exampleText3 }) }\n                            value={ exampleText3 }\n                        \/&gt;\n                    &lt;\/PanelRow&gt;\n\n                        &lt;ToggleControl\n                            checked={ exampleToggle }\n                            help={ __( 'An example toggle.', 'wholesome-plugin') }\n                            label={ __( 'Example Toggle', 'wholesome-plugin') }\n                            onChange={ (exampleToggle) =&gt; setAttributes( { exampleToggle }) }\n                        \/&gt;\n\n                &lt;\/PanelBody&gt;\n            &lt;\/Panel&gt;\n        &lt;\/div&gt;\n    );\n}\n<\/code><\/pre>\n<h3>Lis\u00e4\u00e4 SCSS:\u00e4\u00e4<\/h3>\n<p>Avaa lopuksi <code>\/src\/editor.scss<\/code>tiedosto ja korvaa sen sis\u00e4lt\u00f6 seuraavalla:<\/p>\n<pre><code>.wp-block.wp-block-wholesomecode-wholesome-plugin {\n    color: unset;\n    background: unset;\n    padding: unset;\n\n    .components-base-control {\n        margin-bottom: 1rem;\n\n        select {\n            height: 2rem;\n            min-height: 2rem;\n        }\n    }\n\n    p {\n        all: unset;\n    }\n}\n<\/code><\/pre>\n<ul>\n<li>Tutustu <a href=\"https:\/\/wholesomecode.ltd\/guides\/template-innerblocks-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">sis\u00e4kk\u00e4isten alilohkojen luomiseen <code>InnerBlocks<\/code>komponentin avulla<\/a><\/li>\n<li>Tutustu <a href=\"https:\/\/wholesomecode.ltd\/guides\/options-settings-data-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">asetusten k\u00e4ytt\u00e4miseen tietojen tallentamiseen Gutenbergin asetustaulukkoon<\/a><\/li>\n<\/ul>\n<p><div id=\"PostUnique_PostSource\" style=\"padding-top: 50px\">:  <a target=\"_blank\" rel=\"noopener nofollow\" href=\"\/\/wholesomecode.ltd\" class=\"external external_icon\">wholesomecode.ltd<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Ensimm\u00e4inen kysymys, joka sinulla saattaa olla, on &#8221;miksi minun pit\u00e4isi luoda mukautettuja metalaatikoita Block Editorilla (Gutenberg)?&#8221;, voit silti ottaa metalaatikot k\u00e4ytt\u00f6\u00f6n PHP:ll\u00e4 ja lis\u00e4t\u00e4 ohjausta&#8230;<\/p>\n","protected":false},"author":1,"featured_media":223619,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[938,719,895,917,843,864],"tags":[1166],"class_list":["post-228753","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-gutenberg-5","category-kehittaejae","category-koodi","category-muut","category-opetusohjelmia","category-wordpress-5","tag-affiai-fi"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/posts\/228753","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/comments?post=228753"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/posts\/228753\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/media\/223619"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/media?parent=228753"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/categories?post=228753"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/tags?post=228753"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}