{"id":228645,"date":"2022-10-16T10:00:00","date_gmt":"2022-10-16T07:00:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=228645"},"modified":"2022-11-09T03:30:38","modified_gmt":"2022-11-09T00:30:38","slug":"creer-des-meta-boites-personnalisees-a-laide-de-lediteur-de-blocs-wordpress-gutenberg","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fr\/creer-des-meta-boites-personnalisees-a-laide-de-lediteur-de-blocs-wordpress-gutenberg\/","title":{"rendered":"Cr\u00e9er des m\u00e9ta-bo\u00eetes personnalis\u00e9es \u00e0 l&rsquo;aide de l&rsquo;\u00e9diteur de blocs WordPress (Gutenberg)"},"content":{"rendered":"\n<p>La premi\u00e8re question que vous pourriez vous poser est &quot;pourquoi aurais-je besoin de cr\u00e9er des m\u00e9ta-bo\u00eetes personnalis\u00e9es avec l&rsquo;\u00e9diteur de blocs (Gutenberg)\u00a0?&quot;, vous pouvez toujours impl\u00e9menter des m\u00e9ta-bo\u00eetes avec PHP et ajouter des contr\u00f4les au bloc, \u00e0 la publication ou m\u00eame \u00e0 une barre lat\u00e9rale personnalis\u00e9e. \u00e0 Gutenberg.<\/p>\n<p>Il y a plusieurs raisons pour lesquelles vous pourriez vouloir faire cela, notamment :<\/p>\n<ul>\n<li>Certains blocs ont des param\u00e8tres complexes, et l&rsquo;affichage d&rsquo;une m\u00e9ta-bo\u00eete en mode \u00e9dition peut faciliter son utilisation pour un client<\/li>\n<li>Parce que vous voudrez peut-\u00eatre modifier un certain aspect de la mise en page du message, tel que l&rsquo;en-t\u00eate. Vous pouvez masquer le champ du titre de l&rsquo;article et le remplacer par une bo\u00eete de m\u00e9ta personnalis\u00e9e en haut de la page, et pouvoir contr\u00f4ler toutes les m\u00e9ta de l&rsquo;article qui s&rsquo;y rapportent<\/li>\n<li>Parce que vous pouvez utiliser <a href=\"https:\/\/wholesomecode.ltd\/guides\/register-block-template-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">des mod\u00e8les de blocs<\/a> pour placer les m\u00e9ta-bo\u00eetes personnalis\u00e9es o\u00f9 vous le souhaitez, afin qu&rsquo;elles aient plus de sens dans le contexte<\/li>\n<li>Parce que vous pouvez appliquer cet apprentissage \u00e0 d&rsquo;autres aspects du d\u00e9veloppement de l&rsquo;\u00e9diteur de blocs (Gutenberg)<\/li>\n<\/ul>\n<p>Dans ce guide, nous allons d\u00e9velopper ce que nous avons d\u00e9j\u00e0 construit dans notre <a href=\"https:\/\/wholesomecode.ltd\/guides\/post-meta-fields-store-attributes-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">guide Post Meta Fields<\/a>. Vous pouvez utiliser des attributs de bloc, mais en raison de la nature des m\u00e9ta-bo\u00eetes, nous utiliserons des champs post-m\u00e9ta dans ce guide.<\/p>\n<h2>Conditions pr\u00e9alables<\/h2>\n<ul>\n<li>Se familiariser avec <a href=\"https:\/\/wholesomecode.ltd\/guides\/creating-plugin-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">la cr\u00e9ation de plugins pour WordPress Gutenberg<\/a><\/li>\n<li>Familiarisez-vous avec <a href=\"https:\/\/wholesomecode.ltd\/guides\/php-render-block-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">les blocs dynamiques et le rendu c\u00f4t\u00e9 serveur<\/a><\/li>\n<li>Familiarisez-vous avec l&rsquo;utilisation <a href=\"https:\/\/wholesomecode.ltd\/guides\/post-meta-fields-store-attributes-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">des champs post-m\u00e9ta dans WordPress Gutenberg<\/a><\/li>\n<\/ul>\n<p>Parce que nous suivons le <a href=\"https:\/\/wholesomecode.ltd\/guides\/post-meta-fields-store-attributes-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">guide Post Meta Fields<\/a>, nous aurons d\u00e9j\u00e0 utilis\u00e9 <code>register_meta<\/code>pour cr\u00e9er notre champ post meta, en nous assurant que nous avons d\u00e9fini <code>show_in_rest<\/code>sur true et nous aurons \u00e9galement d\u00e9fini la source de notre attribut JavaScript sur <code>meta<\/code>et d\u00e9fini la cl\u00e9 m\u00e9ta.<\/p>\n<p>Il ne reste plus qu&rsquo;\u00e0 impl\u00e9menter l&rsquo;interface.<\/p>\n<p>Modifiez le <code>\/src\/edit.js<\/code>fichier en rempla\u00e7ant l&rsquo; <code>@wordpress\/components<\/code>importation par ce qui suit\u00a0:<\/p>\n<pre><code>import { Panel, PanelBody, TextControl } from '@wordpress\/components';\n<\/code><\/pre>\n<p>Remplacez ensuite le bloc de code d&rsquo;\u00e9dition par ce qui suit\u00a0:<\/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>Nous avons maintenant un <code>Panel<\/code>, un <code>PanelBody<\/code>et un <code>TextControl<\/code>. Notez que j&rsquo;ai ajout\u00e9 le <code>admin-plugins<\/code>param\u00e8tre \u00e0 l&rsquo;ic\u00f4ne du <code>PanelBody<\/code>pour le garder coh\u00e9rent avec l&rsquo;ic\u00f4ne du plugin.<\/p>\n<h3>Appliquer les styles<\/h3>\n<p>Remplacez le SCSS <code>\/src\/editor.scss<\/code>par ce qui suit\u00a0:<\/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>Si vous utilisez une Custom Meta Box cr\u00e9\u00e9e dans Gutenberg, je vous recommande de la placer avec un <a href=\"https:\/\/wholesomecode.ltd\/guides\/register-block-template-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">mod\u00e8le de bloc<\/a>, mais vous pouvez l&rsquo;ins\u00e9rer normalement comme ceci :<\/p>\n<p>Utilisation d&rsquo;une m\u00e9ta-bo\u00eete personnalis\u00e9e de Gutenberg<\/p>\n<p>Une fois que vous avez cr\u00e9\u00e9 votre m\u00e9ta-bo\u00eete, il n&rsquo;y a pas de limite \u00e0 ce que vous pouvez y ajouter. Toute la biblioth\u00e8que de composants WordPress Gutenberg React est \u00e0 votre disposition, ainsi qu&rsquo;une vaste biblioth\u00e8que de composants React externes (<a href=\"https:\/\/wholesomecode.ltd\/blog\/select2-as-inspectorcontrol-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">voir mon article sur l&rsquo;ajout de select2 dans votre projet<\/a> ).<\/p>\n<p>L&rsquo;exemple suivant est la pointe de l&rsquo;iceberg de ce que vous pouvez r\u00e9aliser\u00a0:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-169030-61e7fb6b454ff.png\" alt=\"Cr\u00e9er des m\u00e9ta-bo\u00eetes personnalis\u00e9es \u00e0 l&#039;aide de l&#039;\u00e9diteur de blocs WordPress (Gutenberg)\" \/>Bo\u00eete m\u00e9ta personnalis\u00e9e avec champs m\u00e9ta suppl\u00e9mentaires<\/p>\n<p>Pour construire ceci, voici le code dont vous avez besoin :<\/p>\n<h3>Enregistrez vos champs m\u00e9ta de publication en PHP<\/h3>\n<p>Ouvrez le fichier PHP racine du plugin (dans ce cas <code>wholesome-plugin.php<\/code>) et mettez \u00e0 jour ce <code>register_meta<\/code>que nous avons ajout\u00e9 dans le guide pr\u00e9c\u00e9dent avec ce qui suit :<\/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>Mettre \u00e0 jour les attributs JavaScript<\/h3>\n<p>Ouvrez <code>\/src\/index.js<\/code>et remplacez les attributs que nous avons ajout\u00e9s dans le guide pr\u00e9c\u00e9dent par les suivants\u00a0:<\/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>Importer les composants<\/h3>\n<p>Modifiez le <code>\/src\/edit.js<\/code>fichier en rempla\u00e7ant l&rsquo; <code>@wordpress\/components<\/code>importation par ce qui suit\u00a0:<\/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>Mettre \u00e0 jour la m\u00e9thode d&rsquo;\u00e9dition<\/h3>\n<p>Continuez \u00e0 modifier le <code>\/src\/edit.js<\/code>fichier en rempla\u00e7ant <code>Edit<\/code>le bloc de code par ce qui suit\u00a0:<\/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>Ajouter du SCSS<\/h3>\n<p>Enfin, ouvrez le <code>\/src\/editor.scss<\/code>fichier et remplacez son contenu par ce qui suit\u00a0:<\/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>D\u00e9couvrez comment cr\u00e9er <a href=\"https:\/\/wholesomecode.ltd\/guides\/template-innerblocks-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">des blocs enfants imbriqu\u00e9s avec le <code>InnerBlocks<\/code>composant<\/a><\/li>\n<li>Jetez un \u0153il \u00e0 <a href=\"https:\/\/wholesomecode.ltd\/guides\/options-settings-data-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">l&rsquo;utilisation des param\u00e8tres pour stocker des donn\u00e9es dans le tableau des options de Gutenberg<\/a><\/li>\n<\/ul>\n<p><div id=\"PostUnique_PostSource\" style=\"padding-top: 50px\">Source d&rsquo;enregistrement:  <a target=\"_blank\" rel=\"noopener nofollow\" href=\"\/\/wholesomecode.ltd\" class=\"external external_icon\">wholesomecode.ltd<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>La premi\u00e8re question que vous pourriez vous poser est \u00ab\u00a0pourquoi aurais-je besoin de cr\u00e9er des m\u00e9ta-bo\u00eetes personnalis\u00e9es avec l&rsquo;\u00e9diteur de blocs (Gutenberg)\u00a0?\u00a0\u00bb, vous pouvez toujours impl\u00e9menter des m\u00e9ta-bo\u00eetes avec PHP et ajouter un contr\u00f4le &#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":[915,893,717,936,841,862],"tags":[1167],"class_list":["post-228645","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-autre","category-code-2","category-developpeur","category-gutenberg-3","category-tutoriels","category-wordpress-3","tag-affiai-fr"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/228645","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/comments?post=228645"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/228645\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media\/223619"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media?parent=228645"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/categories?post=228645"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/tags?post=228645"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}