{"id":228197,"date":"2022-10-16T09:46:00","date_gmt":"2022-10-16T06:46:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=228197"},"modified":"2022-11-09T01:14:44","modified_gmt":"2022-11-08T22:14:44","slug":"tworz-niestandardowe-skrzynki-meta-za-pomoca-edytora-blokow-wordpress-gutenberg","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pl\/tworz-niestandardowe-skrzynki-meta-za-pomoca-edytora-blokow-wordpress-gutenberg\/","title":{"rendered":"Tw\u00f3rz niestandardowe skrzynki Meta za pomoc\u0105 edytora blok\u00f3w WordPress (Gutenberg)"},"content":{"rendered":"\n<p>Pierwsze pytanie, jakie mo\u017cesz mie\u0107, brzmi \u201edlaczego mia\u0142bym tworzy\u0107 niestandardowe pola meta za pomoc\u0105 edytora blok\u00f3w (Gutenberg)?&quot;, nadal mo\u017cesz implementowa\u0107 meta pola za pomoc\u0105 PHP i dodawa\u0107 kontrolki do bloku, posta, a nawet niestandardowego paska bocznego w Gutenbergu.<\/p>\n<p>Jest kilka powod\u00f3w, dla kt\u00f3rych mo\u017cesz chcie\u0107 to zrobi\u0107, w tym:<\/p>\n<ul>\n<li>Niekt\u00f3re bloki maj\u0105 z\u0142o\u017cone ustawienia, a wy\u015bwietlanie meta pola w trybie edycji mo\u017ce u\u0142atwi\u0107 korzystanie z nich przez klienta<\/li>\n<li>Poniewa\u017c mo\u017cesz chcie\u0107 zmieni\u0107 pewien aspekt uk\u0142adu posta, taki jak nag\u0142\u00f3wek. Mo\u017cesz ukry\u0107 pole tytu\u0142u posta i zast\u0105pi\u0107 je niestandardowym polem meta u g\u00f3ry strony i mie\u0107 mo\u017cliwo\u015b\u0107 kontrolowania wszystkich powi\u0105zanych z nim meta post\u00f3w<\/li>\n<li>Poniewa\u017c mo\u017cesz u\u017cy\u0107 <a href=\"https:\/\/wholesomecode.ltd\/guides\/register-block-template-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">szablon\u00f3w blokowych,<\/a> aby umie\u015bci\u0107 niestandardowe pola meta tam, gdzie chcesz, aby mia\u0142y wi\u0119cej sensu w kontek\u015bcie<\/li>\n<li>Poniewa\u017c mo\u017cesz zastosowa\u0107 t\u0119 nauk\u0119 do innych aspekt\u00f3w rozwoju edytora blok\u00f3w (Gutenberg)<\/li>\n<\/ul>\n<p>W tym przewodniku zamierzamy rozwin\u0105\u0107 to, co ju\u017c zbudowali\u015bmy w naszym <a href=\"https:\/\/wholesomecode.ltd\/guides\/post-meta-fields-store-attributes-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">przewodniku Post Meta Fields<\/a>. Mo\u017cesz u\u017cy\u0107 atrybut\u00f3w blokowych, jednak ze wzgl\u0119du na charakter p\u00f3l meta, w tym przewodniku u\u017cyjemy p\u00f3l meta post.<\/p>\n<h2>Warunki wst\u0119pne<\/h2>\n<ul>\n<li>Zapoznaj si\u0119 z <a href=\"https:\/\/wholesomecode.ltd\/guides\/creating-plugin-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">tworzeniem wtyczek do WordPress Gutenberg<\/a><\/li>\n<li>Poznaj <a href=\"https:\/\/wholesomecode.ltd\/guides\/php-render-block-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">dynamiczne bloki i renderowanie po stronie serwera<\/a><\/li>\n<li>Zapoznaj si\u0119 z u\u017cywaniem <a href=\"https:\/\/wholesomecode.ltd\/guides\/post-meta-fields-store-attributes-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">post meta p\u00f3l w WordPress Gutenberg<\/a><\/li>\n<\/ul>\n<p>Poniewa\u017c korzystamy z przewodnika <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<\/a>, b\u0119dziemy ju\u017c u\u017cywa\u0107 <code>register_meta<\/code>do utworzenia naszego meta pola post, upewniaj\u0105c si\u0119, \u017ce ustawili\u015bmy warto\u015b\u0107 <code>show_in_rest<\/code>true, a tak\u017ce ustawili\u015bmy \u017ar\u00f3d\u0142o naszego atrybutu JavaScript na <code>meta<\/code>i zdefiniowali\u015bmy klucz meta.<\/p>\n<p>Pozostaje tylko zaimplementowa\u0107 interfejs.<\/p>\n<p>Edytuj <code>\/src\/edit.js<\/code>plik, zast\u0119puj\u0105c <code>@wordpress\/components<\/code>import nast\u0119puj\u0105cym:<\/p>\n<pre><code>import { Panel, PanelBody, TextControl } from '@wordpress\/components';\n<\/code><\/pre>\n<p>Nast\u0119pnie zast\u0105p blok Edytuj kod nast\u0119puj\u0105cym:<\/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>Mamy teraz <code>Panel<\/code>, a <code>PanelBody<\/code>i <code>TextControl<\/code>. Zauwa\u017c, \u017ce doda\u0142em <code>admin-plugins<\/code>do parametru ikona, <code>PanelBody<\/code>aby zachowa\u0107 sp\u00f3jno\u015b\u0107 z ikon\u0105 wtyczki.<\/p>\n<h3>Zastosuj style<\/h3>\n<p>Zast\u0105p SCSS <code>\/src\/editor.scss<\/code>nast\u0119puj\u0105cym:<\/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>Je\u015bli u\u017cywasz niestandardowego Meta Boxa utworzonego w Gutenbergu, polecam umieszczenie go z <a href=\"https:\/\/wholesomecode.ltd\/guides\/register-block-template-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">szablonem blokowym<\/a>, jednak mo\u017cesz go wstawi\u0107 w normalny spos\u00f3b, w ten spos\u00f3b:<\/p>\n<p>Korzystanie z niestandardowego Meta Boxa Gutenberga<\/p>\n<p>Po utworzeniu meta pola nie ma ogranicze\u0144 co do tego, co mo\u017cesz do niego doda\u0107. Ca\u0142a biblioteka komponent\u00f3w WordPress Gutenberg React jest dost\u0119pna dla Ciebie, wraz z ogromn\u0105 bibliotek\u0105 zewn\u0119trznych komponent\u00f3w React (<a href=\"https:\/\/wholesomecode.ltd\/blog\/select2-as-inspectorcontrol-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">zobacz m\u00f3j artyku\u0142 na temat dodawania select2 do swojego projektu<\/a> ).<\/p>\n<p>Poni\u017cszy przyk\u0142ad jest wierzcho\u0142kiem g\u00f3ry lodowej tego, co mo\u017cesz osi\u0105gn\u0105\u0107:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-169030-61e7fb6b454ff.png\" alt=\"Tw\u00f3rz niestandardowe skrzynki Meta za pomoc\u0105 edytora blok\u00f3w WordPress (Gutenberg)\" \/>Niestandardowe Meta Box z dodatkowymi polami Meta<\/p>\n<p>Aby to zbudowa\u0107, oto kod, kt\u00f3rego potrzebujesz:<\/p>\n<h3>Zarejestruj swoje meta pola postu w PHP<\/h3>\n<p>Otw\u00f3rz g\u0142\u00f3wny plik PHP wtyczki (w tym przypadku <code>wholesome-plugin.php<\/code>) i zaktualizuj plik <code>register_meta<\/code>dodany w poprzednim przewodniku w nast\u0119puj\u0105cy spos\u00f3b:<\/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>Zaktualizuj atrybuty JavaScript<\/h3>\n<p>Otw\u00f3rz <code>\/src\/index.js<\/code>i zast\u0105p atrybuty, kt\u00f3re dodali\u015bmy w poprzednim przewodniku, nast\u0119puj\u0105cymi:<\/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>Importuj komponenty<\/h3>\n<p>Edytuj <code>\/src\/edit.js<\/code>plik, zast\u0119puj\u0105c <code>@wordpress\/components<\/code>import nast\u0119puj\u0105cym:<\/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>Zaktualizuj metod\u0119 edycji<\/h3>\n<p>Kontynuuj edycj\u0119 <code>\/src\/edit.js<\/code>pliku, zast\u0119puj\u0105c <code>Edit<\/code>blok kodu nast\u0119puj\u0105cym:<\/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>Dodaj troch\u0119 SCSS<\/h3>\n<p>Na koniec otw\u00f3rz <code>\/src\/editor.scss<\/code>plik i zast\u0105p jego zawarto\u015b\u0107 nast\u0119puj\u0105cym:<\/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>Sp\u00f3jrz na tworzenie <a href=\"https:\/\/wholesomecode.ltd\/guides\/template-innerblocks-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">zagnie\u017cd\u017conych blok\u00f3w podrz\u0119dnych za pomoc\u0105 <code>InnerBlocks<\/code>komponentu<\/a><\/li>\n<li>Zobacz, jak <a href=\"https:\/\/wholesomecode.ltd\/guides\/options-settings-data-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">u\u017cywa\u0107 ustawie\u0144 do przechowywania danych w tabeli opcji w Gutenberg<\/a><\/li>\n<\/ul>\n<p><div id=\"PostUnique_PostSource\" style=\"padding-top: 50px\">\u0179r\u00f3d\u0142o nagrywania:  <a target=\"_blank\" rel=\"noopener nofollow\" href=\"\/\/wholesomecode.ltd\" class=\"external external_icon\">wholesomecode.ltd<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Pierwsze pytanie, jakie mo\u017cesz mie\u0107, brzmi \u201edlaczego mia\u0142bym tworzy\u0107 niestandardowe pola meta za pomoc\u0105 edytora blok\u00f3w (Gutenberg)?\u201d, nadal mo\u017cesz zaimplementowa\u0107 meta pola za pomoc\u0105 PHP i doda\u0107 kontrol\u0119 &#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":[721,940,919,897,845,866],"tags":[1169],"class_list":["post-228197","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-deweloper","category-gutenberg-7","category-inny","category-kod","category-samouczki","category-wordpress-7","tag-affiai-pl"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/posts\/228197","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/comments?post=228197"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/posts\/228197\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/media\/223619"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/media?parent=228197"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/categories?post=228197"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/tags?post=228197"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}