{"id":228718,"date":"2022-10-18T17:35:00","date_gmt":"2022-10-18T14:35:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=228718"},"modified":"2022-11-09T04:00:41","modified_gmt":"2022-11-09T01:00:41","slug":"creer-une-page-de-parametres-a-laide-des-composants-wordpress-block-editor-gutenberg","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fr\/creer-une-page-de-parametres-a-laide-des-composants-wordpress-block-editor-gutenberg\/","title":{"rendered":"Cr\u00e9er une page de param\u00e8tres \u00e0 l&rsquo;aide des composants WordPress Block Editor (Gutenberg)"},"content":{"rendered":"\n<p>Nous avons d\u00e9j\u00e0 examin\u00e9 le <a href=\"https:\/\/wholesomecode.ltd\/guides\/options-settings-data-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">stockage des options et des param\u00e8tres \u00e0 l&rsquo;aide de l&rsquo;\u00e9diteur de blocs WordPress (Gutenberg)<\/a> et <a href=\"https:\/\/wholesomecode.ltd\/guides\/entry-points-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">l&rsquo;extension du script de cr\u00e9ation de bloc pour permettre des points de terminaison suppl\u00e9mentaires<\/a>. Dans ce guide, nous allons tous les rassembler pour cr\u00e9er une page de param\u00e8tres utilisant des composants Gutenberg.<\/p>\n<p>La page des param\u00e8tres que nous sommes sur le point de cr\u00e9er<\/p>\n<p>Mais d&rsquo;abord, tout le m\u00e9rite revient, l&rsquo;inspiration pour ce guide va \u00e0 l&rsquo;article Code in WP de Hardeep Asrani: <a href=\"https:\/\/www.codeinwp.com\/blog\/plugin-options-page-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Making a &quot;Plugin Options Page&quot; With Gutenberg Components<\/a>.<\/p>\n<h2>Conditions pr\u00e9alables<\/h2>\n<ul>\n<li>Avoir suivi le guide <a href=\"https:\/\/wholesomecode.ltd\/guides\/creating-plugin-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Cr\u00e9ation d&rsquo;un plugin pour l&rsquo;\u00e9diteur de blocs WordPress (Gutenberg)<\/a><\/li>\n<li>Avoir suivi le guide <a href=\"https:\/\/wholesomecode.ltd\/guides\/options-settings-data-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Utilisation des options pour stocker des donn\u00e9es dans l&rsquo;\u00e9diteur de blocs WordPress (Gutenberg)<\/a><\/li>\n<li>Avoir suivi le guide <a href=\"https:\/\/wholesomecode.ltd\/guides\/entry-points-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Ajouter des points d&rsquo;entr\u00e9e au<\/a> guide WordPress Cr\u00e9er un script de bloc<\/li>\n<\/ul>\n<h2>Cr\u00e9er la page des param\u00e8tres en PHP<\/h2>\n<p>Suite aux guides des pr\u00e9requis, ouvrez le fichier PHP racine du plugin (dans ce cas <code>wholesome-plugin.php<\/code>) et ajoutez ce qui suit :<\/p>\n<h3>Enregistrez les param\u00e8tres<\/h3>\n<p>Comme dans le <a href=\"https:\/\/wholesomecode.ltd\/guides\/options-settings-data-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">guide d&rsquo;utilisation des options pour stocker les donn\u00e9es,<\/a> ajoutez les param\u00e8tres suivants au fichier\u00a0:<\/p>\n<pre><code>function wholesomecode_wholesome_plugin_register_settings() {\n    register_setting(\n        'wholesomecode_wholesome_plugin_settings',\n        'wholesomecode_wholesome_plugin_example_select',\n        [\n            'default'      =&gt; '',\n            'show_in_rest' =&gt; true,\n            'type'         =&gt; 'string',\n        ]\n    );\n\n    register_setting(\n        'wholesomecode_wholesome_plugin_settings',\n        'wholesomecode_wholesome_plugin_example_text',\n        [\n            'default'      =&gt; '',\n            'show_in_rest' =&gt; true,\n            'type'         =&gt; 'string',\n        ]\n    );\n\n    register_setting(\n        'wholesomecode_wholesome_plugin_settings',\n        'wholesomecode_wholesome_plugin_example_text_2',\n        [\n            'default'      =&gt; '',\n            'show_in_rest' =&gt; true,\n            'type'         =&gt; 'string',\n        ]\n    );\n\n    register_setting(\n        'wholesomecode_wholesome_plugin_settings',\n        'wholesomecode_wholesome_plugin_example_text_3',\n        [\n            'default'      =&gt; '',\n            'show_in_rest' =&gt; true,\n            'type'         =&gt; 'string',\n        ]\n    );\n\n    register_setting(\n        'wholesomecode_wholesome_plugin_settings',\n        'wholesomecode_wholesome_plugin_example_toggle',\n        [\n            'default'      =&gt; '',\n            'show_in_rest' =&gt; true,\n            'type'         =&gt; 'string',\n        ]\n    );\n}\nadd_action( 'init', 'wholesomecode_wholesome_plugin_register_settings', 10 );\n<\/code><\/pre>\n<p>Enregistrez les param\u00e8tres auxquels nous aurons acc\u00e8s sur la page des param\u00e8tres. Assurez-vous de r\u00e9gler <code>show_in_rest<\/code>sur <code>true<\/code>pour chacun, afin qu&rsquo;ils soient accessibles via Gutenberg.<\/p>\n<h3>Enregistrez la page des param\u00e8tres<\/h3>\n<p>Ajoutez le bloc de code pour enregistrer la page des param\u00e8tres\u00a0:<\/p>\n<pre><code>function wholesomecode_wholesome_plugin_settings_page() {\n    add_options_page(\n        __( 'Wholesome Plugin Settings', 'wholesome-plugin' ),\n        __( 'Wholesome Plugin Settings', 'wholesome-plugin' ),\n        'manage_options',\n        'wholesome_plugin_settings',\n        function() {\n            ?&gt;\n            &lt;div id=\"wholesome-plugin-settings\"&gt;&lt;\/div&gt;\n            &lt;?php\n        },\n    );\n}\nadd_action( 'admin_menu', 'wholesomecode_wholesome_plugin_settings_page', 10 );\n<\/code><\/pre>\n<p>Le code ci-dessus ajoute une nouvelle page au menu des param\u00e8tres. Notez que tout ce qu&rsquo;il fait est de sortir un <code>&lt;div&gt;<\/code>, c&rsquo;est ce que nous utiliserons pour rendre les composants Gutenberg bas\u00e9s sur React.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168686-61e7f0058b713.png\" alt=\"Cr\u00e9er une page de param\u00e8tres \u00e0 l&#039;aide des composants WordPress Block Editor (Gutenberg)\" \/>\u00c9l\u00e9ment du menu Param\u00e8tres<\/p>\n<h3>Mettre en file d&rsquo;attente les ressources d&rsquo;administration<\/h3>\n<p>Pour le prochain bloc de code, nous devons avoir suivi toutes les \u00e9tapes du guide <a href=\"https:\/\/wholesomecode.ltd\/guides\/entry-points-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Ajouter des points d&rsquo;entr\u00e9e au<\/a> guide Cr\u00e9er un script de bloc. Assurez-vous de suivre toutes les \u00e9tapes de ce guide avant cette \u00e9tape, puis revenez et suivez le reste de ce guide.<\/p>\n<pre><code>function wholesomecode_wholesome_plugin_admin_scripts() {\n    $dir = __DIR__;\n\n    $script_asset_path = \"$dir\/build\/admin.asset.php\";\n    if (! file_exists( $script_asset_path)) {\n        throw new Error(\n            'You need to run `npm start` or `npm run build` for the \"wholesomecode\/wholesome-plugin\" block first.'\n        );\n    }\n    $admin_js     = 'build\/admin.js';\n    $script_asset = require( $script_asset_path );\n    wp_enqueue_script(\n        'wholesomecode-wholesome-plugin-admin-editor',\n        plugins_url( $admin_js, __FILE__ ),\n        $script_asset['dependencies'],\n        $script_asset['version']\n    );\n    wp_set_script_translations( 'wholesomecode-wholesome-plugin-block-editor', 'wholesome-plugin' );\n\n    $admin_css = 'build\/admin.css';\n    wp_enqueue_style(\n        'wholesomecode-wholesome-plugin-admin',\n        plugins_url( $admin_css, __FILE__ ),\n        ['wp-components'],\n        filemtime( \"$dir\/$admin_css\") );\n}\nadd_action( 'admin_enqueue_scripts', 'wholesomecode_wholesome_plugin_admin_scripts', 10 );\n<\/code><\/pre>\n<h2>Construire la page d&rsquo;administration en JavaScript<\/h2>\n<p>Si vous avez suivi toutes les \u00e9tapes du guide <a href=\"https:\/\/wholesomecode.ltd\/guides\/entry-points-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Add Entry Points to the Create Block Script<\/a>, vous devriez avoir un <code>\/src\/admin.js<\/code>fichier. Ouvrez ce fichier et supprimez son contenu.<\/p>\n<h3>Rendre le composant<\/h3>\n<p>N&rsquo;oubliez pas d&rsquo;ex\u00e9cuter <code>npm start<\/code>dans votre terminal conform\u00e9ment au <a href=\"https:\/\/wholesomecode.ltd\/guides\/entry-points-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">guide de cr\u00e9ation de plug<\/a> -ins et ajoutez ce qui suit \u00e0 votre <code>\/src\/admin.js<\/code>fichier.<\/p>\n<pre><code>import '.\/admin.scss';\nimport { Icon } from '@wordpress\/components';\nimport {\n    Fragment,\n    render,\n    Component,\n} from '@wordpress\/element';\nimport { __ } from '@wordpress\/i18n';\n\nclass App extends Component {\n    constructor() {\n        super( ...arguments );\n    }\n\n    render() {\n        return (&lt;Fragment&gt;\n                &lt;div className=\"wholesome-plugin__header\"&gt;\n                    &lt;div className=\"wholesome-plugin__container\"&gt;\n                        &lt;div className=\"wholesome-plugin__title\"&gt;\n                            &lt;h1&gt;{ __( 'Wholesome Plugin Settings', 'wholesome-plugin') } &lt;Icon icon=\"admin-plugins\" \/&gt;&lt;\/h1&gt;\n                        &lt;\/div&gt;\n                    &lt;\/div&gt;\n                &lt;\/div&gt;\n                &lt;div className=\"wholesome-plugin__main\"&gt;&lt;\/div&gt;\n            &lt;\/Fragment&gt;) }\n}\n\ndocument.addEventListener( 'DOMContentLoaded',() =&gt; {\n    const htmlOutput = document.getElementById( 'wholesome-plugin-settings' );\n\n    if (htmlOutput) {\n        render(\n            &lt;App \/&gt;,\n            htmlOutput\n        );\n    }\n});\n<\/code><\/pre>\n<p>Si vous acc\u00e9dez \u00e0 votre page de param\u00e8tres dans le navigateur, vous devriez maintenant voir ce qui suit\u00a0:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168686-61e7f00682524.png\" alt=\"Cr\u00e9er une page de param\u00e8tres \u00e0 l&#039;aide des composants WordPress Block Editor (Gutenberg)\" \/>Rendu des composants dans l&rsquo;\u00e9cran des param\u00e8tres<\/p>\n<h3>Ajouter les champs de param\u00e8tres<\/h3>\n<p>Vous souvenez-vous des \u00e9tapes suppl\u00e9mentaires du guide &quot;Utilisation des options pour stocker des donn\u00e9es&quot;\u00a0? Eh bien, nous allons \u00e0 peu pr\u00e8s coller ces verbatim dans ce composant, vous devriez donc vous retrouver avec un code qui ressemble un peu \u00e0 ceci\u00a0:<\/p>\n<pre><code>import '.\/admin.scss';\n\nimport api from '@wordpress\/api';\n\nimport {\n    Button,\n    Icon,\n    Panel,\n    PanelBody,\n    PanelRow,\n    Placeholder,\n    SelectControl,\n    Spinner,\n    TextControl,\n    ToggleControl,\n} from '@wordpress\/components';\n\nimport {\n    Fragment,\n    render,\n    Component,\n} from '@wordpress\/element';\n\nimport { __ } from '@wordpress\/i18n';\n\nclass App extends Component {\n    constructor() {\n        super( ...arguments );\n\n        this.state = {\n            exampleSelect: '',\n            exampleText: '',\n            exampleText2: '',\n            exampleText3: '',\n            exampleToggle: false,\n            isAPILoaded: false,\n        };\n    }\n\n    componentDidMount() {\n\n        api.loadPromise.then(() =&gt; {\n            this.settings = new api.models.Settings();\n\n            const { isAPILoaded } = this.state;\n\n            if (isAPILoaded === false) {\n                this.settings.fetch().then( (response) =&gt; {\n                    this.setState( {\n                        exampleSelect: response[ 'wholesomecode_wholesome_plugin_example_select' ],\n                        exampleText: response[ 'wholesomecode_wholesome_plugin_example_text' ],\n                        exampleText2: response[ 'wholesomecode_wholesome_plugin_example_text_2' ],\n                        exampleText3: response[ 'wholesomecode_wholesome_plugin_example_text_3' ],\n                        exampleToggle: Boolean( response[ 'wholesomecode_wholesome_plugin_example_toggle' ] ),\n                        isAPILoaded: true,\n                    } );\n                } );\n            }\n        } );\n    }\n\n    render() {\n        const {\n            exampleSelect,\n            exampleText,\n            exampleText2,\n            exampleText3,\n            exampleToggle,\n            isAPILoaded,\n        } = this.state;\n\n        if (! isAPILoaded) {\n            return (&lt;Placeholder&gt;\n                    &lt;Spinner \/&gt;\n                &lt;\/Placeholder&gt;\n            );\n        }\n\n        return (&lt;Fragment&gt;\n                &lt;div className=\"wholesome-plugin__header\"&gt;\n                    &lt;div className=\"wholesome-plugin__container\"&gt;\n                        &lt;div className=\"wholesome-plugin__title\"&gt;\n                            &lt;h1&gt;{ __( 'Wholesome Plugin Settings', 'wholesome-plugin') } &lt;Icon icon=\"admin-plugins\" \/&gt;&lt;\/h1&gt;\n                        &lt;\/div&gt;\n                    &lt;\/div&gt;\n                &lt;\/div&gt;\n\n                &lt;div className=\"wholesome-plugin__main\"&gt;\n                    &lt;Panel&gt;\n                        &lt;PanelBody\n                            title={ __( 'Panel Body One', 'wholesome-plugin') }\n                            icon=\"admin-plugins\"\n                        &gt;\n                            &lt;SelectControl\n                                help={ __( 'An example dropdown field.', 'wholesome-plugin') }\n                                label={ __( 'Example Select', 'wholesome-plugin') }\n                                onChange={ (exampleSelect) =&gt; this.setState( { 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                        &lt;\/PanelBody&gt;\n                        &lt;PanelBody\n                            title={ __( 'Panel Body Two', 'wholesome-plugin') }\n                            icon=\"admin-plugins\"\n                        &gt;\n                            &lt;TextControl\n                                help={ __( 'This is an example text field.', 'wholesome-plugin') }\n                                label={ __( 'Example Text', 'wholesome-plugin') }\n                                onChange={ (exampleText) =&gt; this.setState( { exampleText }) }\n                                value={ exampleText }\n                            \/&gt;\n\n                        &lt;\/PanelBody&gt;\n                        &lt;PanelBody\n                            title={ __( 'Panel Body Three', 'wholesome-plugin') }\n                            icon=\"admin-plugins\"\n                        &gt;\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; this.setState( { 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; this.setState( { exampleText3 }) }\n                                    value={ exampleText3 }\n                                \/&gt;\n                            &lt;\/PanelRow&gt;\n                        &lt;\/PanelBody&gt;\n                        &lt;PanelBody\n                            title={ __( 'Panel Body Four', 'wholesome-plugin') }\n                            icon=\"admin-plugins\"\n                        &gt;\n                            &lt;ToggleControl\n                                checked={ exampleToggle }\n                                help={ __( 'An example toggle.', 'wholesome-plugin') }\n                                label={ __( 'Example Toggle', 'wholesome-plugin') }\n                                onChange={ (exampleToggle) =&gt; this.setState( { exampleToggle }) }\n                            \/&gt;\n                        &lt;\/PanelBody&gt;\n                        &lt;Button\n                            isPrimary\n                            isLarge\n                            onClick={ () =&gt; {}}\n                        &gt;\n                            { __( 'Save', 'wholesome-plugin') }\n                        &lt;\/Button&gt;\n                    &lt;\/Panel&gt;\n                &lt;\/div&gt;\n            &lt;\/Fragment&gt;) }\n}\n\ndocument.addEventListener( 'DOMContentLoaded', () =&gt; {\n    const htmlOutput = document.getElementById( 'wholesome-plugin-settings' );\n\n    if (htmlOutput) {\n        render(\n            &lt;App \/&gt;,\n            htmlOutput\n        );\n    }\n});\n<\/code><\/pre>\n<p>Outre la suppression du <code>subscribe<\/code>in <code>componentDidMount<\/code>que nous utilisions pr\u00e9c\u00e9demment pour enregistrer dans ce guide et l&rsquo;ajout du bouton, le code est \u00e0 peu pr\u00e8s un copier-coller.<\/p>\n<p>Tout va bien, notre page de param\u00e8tres devrait maintenant ressembler un peu \u00e0 ceci\u00a0:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168686-61e7f007658c6.png\" alt=\"Cr\u00e9er une page de param\u00e8tres \u00e0 l&#039;aide des composants WordPress Block Editor (Gutenberg)\" \/>Rendu des champs de param\u00e8tres<\/p>\n<p>Ne vous inqui\u00e9tez pas, nous allons nettoyer les styles dans la section 4 de ce guide.<\/p>\n<h3>G\u00e9rer la sauvegarde<\/h3>\n<p>Dans le <code>onClick<\/code>gestionnaire du <code>&lt;button&gt;<\/code>composant ajoutez le code suivant\u00a0:<\/p>\n<pre><code>&lt;Button\n  isPrimary\n  isLarge\n  onClick={ () =&gt; {\n    const {\n      exampleSelect,\n      exampleText,\n      exampleText2,\n      exampleText3,\n      exampleToggle,\n    } = this.state;\n\n    const settings = new api.models.Settings( {\n      [ 'wholesomecode_wholesome_plugin_example_select' ]: exampleSelect,\n      [ 'wholesomecode_wholesome_plugin_example_text' ]: exampleText,\n      [ 'wholesomecode_wholesome_plugin_example_text_2' ]: exampleText2,\n      [ 'wholesomecode_wholesome_plugin_example_text_3' ]: exampleText3,\n      [ 'wholesomecode_wholesome_plugin_example_toggle' ]: exampleToggle? 'true': '',\n    } );\n    settings.save();\n  }}\n  &gt;\n  { __( 'Save', 'wholesome-plugin') }\n&lt;\/Button&gt;\n<\/code><\/pre>\n<p>Cela enregistrera nos options et param\u00e8tres lorsque le bouton sera cliqu\u00e9. Cependant, rien n&rsquo;indique que les options ont \u00e9t\u00e9 enregistr\u00e9es par d\u00e9faut.<\/p>\n<h3>Cr\u00e9er la notification<\/h3>\n<p>Pour informer notre utilisateur que les options et les param\u00e8tres ont \u00e9t\u00e9 enregistr\u00e9s, impl\u00e9mentons une notification &quot;snackbar&quot;. Il s&rsquo;agit de la m\u00eame notification utilis\u00e9e dans l&rsquo;\u00e9cran principal de l&rsquo;\u00e9diteur de publication que l&rsquo;\u00e9diteur de bloc utilise lorsque la publication a \u00e9t\u00e9 enregistr\u00e9e.<\/p>\n<p>Pour ajouter cela, nous devons porter un composant principal de Gutenberg dans notre build, car la liste des notifications n&rsquo;est pas disponible \u00e0 l&rsquo;aide des instructions d&rsquo;importation habituelles.<\/p>\n<p>Nous devrons ajouter le code suivant dans le fichier\u00a0:<\/p>\n<pre><code>import { SnackbarList } from '@wordpress\/components';\n\nimport {\n    dispatch,\n    useDispatch,\n    useSelect,\n} from '@wordpress\/data';\n\nimport { store as noticesStore } from '@wordpress\/notices';\n\nconst Notices = () =&gt; {\n    const notices = useSelect( (select) =&gt;\n            select( noticesStore) .getNotices()\n                .filter( (notice) =&gt; notice.type === 'snackbar' ),\n        []\n    );\n    const { removeNotice } = useDispatch( noticesStore );\n    return (&lt;SnackbarList\n            className=\"edit-site-notices\"\n            notices={ notices }\n            onRemove={ removeNotice }\n        \/&gt;\n    );\n};\n<\/code><\/pre>\n<p>Ensuite, dans le rendu principal du <code>&lt;App&gt;<\/code>composant, ajoutez ce qui suit avant la fermeture<code>&lt;\/Fragment&gt;<\/code>\u00a0:<\/p>\n<pre><code>&lt;div className=\"wholesome-plugin__notices\"&gt;\n  &lt;Notices\/&gt;\n&lt;\/div&gt;\n<\/code><\/pre>\n<p>Enfin, ajoutez ce qui suit au <code>onClick<\/code>gestionnaire du bouton\u00a0:<\/p>\n<pre><code>dispatch('core\/notices').createNotice(\n  'success',\n  __( 'Settings Saved', 'wholesome-plugin' ),\n  {\n    type: 'snackbar',\n    isDismissible: true,\n  }\n);\n<\/code><\/pre>\n<p>Cela cr\u00e9era une petite fen\u00eatre contextuelle &quot;snackbar&quot; chaque fois que les param\u00e8tres seront enregistr\u00e9s.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168686-61e7f00850403.png\" alt=\"Cr\u00e9er une page de param\u00e8tres \u00e0 l&#039;aide des composants WordPress Block Editor (Gutenberg)\" \/>Notification de snack en action<\/p>\n<p>Je sais, je sais, nous devons encore corriger ces styles.<\/p>\n<h3><code>\/src\/admin.js<\/code>Le dossier complet<\/h3>\n<p>Pour r\u00e9f\u00e9rence, voici le <code>\/src\/admin.js<\/code>code complet du fichier\u00a0:<\/p>\n<pre><code>import '.\/admin.scss';\n\nimport api from '@wordpress\/api';\n\nimport {\n    Button,\n    Icon,\n    Panel,\n    PanelBody,\n    PanelRow,\n    Placeholder,\n    SelectControl,\n    SnackbarList,\n    Spinner,\n    TextControl,\n    ToggleControl,\n} from '@wordpress\/components';\n\nimport {\n    dispatch,\n    useDispatch,\n    useSelect,\n} from '@wordpress\/data';\n\nimport {\n    Fragment,\n    render,\n    Component,\n} from '@wordpress\/element';\n\nimport { __ } from '@wordpress\/i18n';\n\nimport { store as noticesStore } from '@wordpress\/notices';\n\nconst Notices = () =&gt; {\n    const notices = useSelect( (select) =&gt;\n            select( noticesStore) .getNotices()\n                .filter( (notice) =&gt; notice.type === 'snackbar' ),\n        []\n    );\n    const { removeNotice } = useDispatch( noticesStore );\n    return (&lt;SnackbarList\n            className=\"edit-site-notices\"\n            notices={ notices }\n            onRemove={ removeNotice }\n        \/&gt;\n    );\n};\n\nclass App extends Component {\n    constructor() {\n        super( ...arguments );\n\n        this.state = {\n            exampleSelect: '',\n            exampleText: '',\n            exampleText2: '',\n            exampleText3: '',\n            exampleToggle: false,\n            isAPILoaded: false,\n        };\n    }\n\n    componentDidMount() {\n\n        api.loadPromise.then( () =&gt; {\n            this.settings = new api.models.Settings();\n\n            const { isAPILoaded } = this.state;\n\n            if (isAPILoaded === false) {\n                this.settings.fetch().then( (response) =&gt; {\n                    this.setState( {\n                        exampleSelect: response[ 'wholesomecode_wholesome_plugin_example_select' ],\n                        exampleText: response[ 'wholesomecode_wholesome_plugin_example_text' ],\n                        exampleText2: response[ 'wholesomecode_wholesome_plugin_example_text_2' ],\n                        exampleText3: response[ 'wholesomecode_wholesome_plugin_example_text_3' ],\n                        exampleToggle: Boolean( response[ 'wholesomecode_wholesome_plugin_example_toggle' ] ),\n                        isAPILoaded: true,\n                    } );\n                } );\n            }\n        } );\n    }\n\n    render() {\n        const {\n            exampleSelect,\n            exampleText,\n            exampleText2,\n            exampleText3,\n            exampleToggle,\n            isAPILoaded,\n        } = this.state;\n\n        if (! isAPILoaded) {\n            return (&lt;Placeholder&gt;\n                    &lt;Spinner \/&gt;\n                &lt;\/Placeholder&gt;\n            );\n        }\n\n        return (&lt;Fragment&gt;\n                &lt;div className=\"wholesome-plugin__header\"&gt;\n                    &lt;div className=\"wholesome-plugin__container\"&gt;\n                        &lt;div className=\"wholesome-plugin__title\"&gt;\n                            &lt;h1&gt;{ __( 'Wholesome Plugin Settings', 'wholesome-plugin') } &lt;Icon icon=\"admin-plugins\" \/&gt;&lt;\/h1&gt;\n                        &lt;\/div&gt;\n                    &lt;\/div&gt;\n                &lt;\/div&gt;\n\n                &lt;div className=\"wholesome-plugin__main\"&gt;\n                    &lt;Panel&gt;\n                        &lt;PanelBody\n                            title={ __( 'Panel Body One', 'wholesome-plugin') }\n                            icon=\"admin-plugins\"\n                        &gt;\n                            &lt;SelectControl\n                                help={ __( 'An example dropdown field.', 'wholesome-plugin') }\n                                label={ __( 'Example Select', 'wholesome-plugin') }\n                                onChange={ (exampleSelect) =&gt; this.setState( { 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                        &lt;\/PanelBody&gt;\n                        &lt;PanelBody\n                            title={ __( 'Panel Body Two', 'wholesome-plugin') }\n                            icon=\"admin-plugins\"\n                        &gt;\n                            &lt;TextControl\n                                help={ __( 'This is an example text field.', 'wholesome-plugin') }\n                                label={ __( 'Example Text', 'wholesome-plugin') }\n                                onChange={ (exampleText) =&gt; this.setState( { exampleText }) }\n                                value={ exampleText }\n                            \/&gt;\n\n                        &lt;\/PanelBody&gt;\n                        &lt;PanelBody\n                            title={ __( 'Panel Body Three', 'wholesome-plugin') }\n                            icon=\"admin-plugins\"\n                        &gt;\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; this.setState( { 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; this.setState( { exampleText3 }) }\n                                    value={ exampleText3 }\n                                \/&gt;\n                            &lt;\/PanelRow&gt;\n                        &lt;\/PanelBody&gt;\n                        &lt;PanelBody\n                            title={ __( 'Panel Body Four', 'wholesome-plugin') }\n                            icon=\"admin-plugins\"\n                        &gt;\n                            &lt;ToggleControl\n                                checked={ exampleToggle }\n                                help={ __( 'An example toggle.', 'wholesome-plugin') }\n                                label={ __( 'Example Toggle', 'wholesome-plugin') }\n                                onChange={ (exampleToggle) =&gt; this.setState( { exampleToggle }) }\n                            \/&gt;\n                        &lt;\/PanelBody&gt;\n                        &lt;Button\n                            isPrimary\n                            isLarge\n                            onClick={ () =&gt; {\n                                const {\n                                    exampleSelect,\n                                    exampleText,\n                                    exampleText2,\n                                    exampleText3,\n                                    exampleToggle,\n                                } = this.state;\n\n                                const settings = new api.models.Settings( {\n                                    [ 'wholesomecode_wholesome_plugin_example_select' ]: exampleSelect,\n                                    [ 'wholesomecode_wholesome_plugin_example_text' ]: exampleText,\n                                    [ 'wholesomecode_wholesome_plugin_example_text_2' ]: exampleText2,\n                                    [ 'wholesomecode_wholesome_plugin_example_text_3' ]: exampleText3,\n                                    [ 'wholesomecode_wholesome_plugin_example_toggle' ]: exampleToggle? 'true': '',\n                                } );\n                                settings.save();\n\n                                dispatch('core\/notices').createNotice(\n                                    'success',\n                                    __( 'Settings Saved', 'wholesome-plugin' ),\n                                    {\n                                        type: 'snackbar',\n                                        isDismissible: true,\n                                    }\n                                );\n                            }}\n                        &gt;\n                            { __( 'Save', 'wholesome-plugin') }\n                        &lt;\/Button&gt;\n                    &lt;\/Panel&gt;\n                &lt;\/div&gt;\n\n                &lt;div className=\"wholesome-plugin__notices\"&gt;\n                    &lt;Notices\/&gt;\n                &lt;\/div&gt;\n\n            &lt;\/Fragment&gt;) }\n}\n\ndocument.addEventListener( 'DOMContentLoaded', () =&gt; {\n    const htmlOutput = document.getElementById( 'wholesome-plugin-settings' );\n\n    if (htmlOutput) {\n        render(\n            &lt;App \/&gt;,\n            htmlOutput\n        );\n    }\n});\n<\/code><\/pre>\n<h2>Ajouter le SCSS<\/h2>\n<p>Il est temps de corriger ces styles. Ajoutez simplement ce qui suit dans le <code>\/src\/admin.scss<\/code>fichier (que vous auriez cr\u00e9\u00e9 dans le guide <a href=\"https:\/\/wholesomecode.ltd\/guides\/entry-points-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Ajouter des points d&rsquo;entr\u00e9e au<\/a> guide Cr\u00e9er un script de bloc.<\/p>\n<pre><code>#wholesome-plugin-settings {\n\n    .components-placeholder {\n        background: #f1f1f1;\n    }\n\n    .wholesome-plugin__header {\n        background-color: #ffffff;\n        box-shadow: 0 1px 0 rgba(213, 213, 213, .5), 0 1px 2px #eeeeee;\n        margin-left: -2em;\n        padding: 20px 10px;\n\n        .wholesome-plugin__container {\n            margin: 0 auto;\n            max-width: 750px;\n\n            .wholesome-plugin__title {\n                align-items: center;\n                display: flex;\n                justify-content: center;\n\n                .dashicon {\n                    color: #757575;\n                }\n            }\n        }\n    }\n\n    .wholesome-plugin__main {\n        margin-left: auto;\n        margin-right: auto;\n        max-width: 750px;\n\n        .components-panel {\n            background: none;\n            border: none;\n        }\n\n        .components-panel__body {\n            background: #ffffff;\n            border: 1px solid #e2e4e7;\n            margin: 1rem 0;\n        }\n    }\n\n    .components-base-control__help {\n        margin-top: .5rem;\n    }\n\n    .components-panel__row {\n        &gt; div {\n            flex-grow: 1;\n            margin-right: 1rem;\n\n            &amp;:last-of-type {\n                margin-right: 0;\n            }\n        }\n    }\n\n    .wholesome-plugin__notices {\n        .components-snackbar {\n            bottom: .5rem;\n            position: fixed;\n        }\n    }\n}\n<\/code><\/pre>\n<h2>Affichage de la page des param\u00e8tres<\/h2>\n<p>Voici le r\u00e9sultat final :<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168686-61e7f0098b5d1.gif\" alt=\"Cr\u00e9er une page de param\u00e8tres \u00e0 l&#039;aide des composants WordPress Block Editor (Gutenberg)\" \/>La page des param\u00e8tres<\/p>\n<p>Certains plugins ont un lien &quot;param\u00e8tres&quot; dans la page des plugins comme ceci\u00a0:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168686-61e7f00b64270.png\" alt=\"Cr\u00e9er une page de param\u00e8tres \u00e0 l&#039;aide des composants WordPress Block Editor (Gutenberg)\" \/>Lien Param\u00e8tres sur le panneau de la page des param\u00e8tres du plugin<\/p>\n<p>Pour ce faire, ajoutez le bloc de code suivant \u00e0 la racine de votre fichier de plug-in (dans ce cas<code>wholesome-plugin.php<\/code>\u00a0:<\/p>\n<pre><code>function wholesomecode_wholesome_plugin_settings_link( $links ): array {\n    $label = esc_html__( 'Settings', 'wholesome-plugin' );\n    $slug  = 'wholesome_plugin_settings';\n\n    array_unshift( $links, \"&lt;a href='options-general.php?page=$slug'&gt;$label&lt;\/a&gt;\" );\n\n    return $links;\n}\nadd_action( 'plugin_action_links_'. plugin_basename( __FILE__ ), 'wholesomecode_wholesome_plugin_settings_link', 10 );\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\/post-meta-fields-store-attributes-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">l&rsquo;utilisation des champs post-m\u00e9ta dans les blocs Gutenberg<\/a><\/li>\n<li>Jetez un \u0153il \u00e0 <a href=\"https:\/\/wholesomecode.ltd\/guides\/create-customizer-panel-wordpress-gutenberg-components\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">la cr\u00e9ation d&rsquo;un panneau de personnalisation avec des composants 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>Nous avons pr\u00e9c\u00e9demment examin\u00e9 le stockage des options et des param\u00e8tres \u00e0 l&rsquo;aide de l&rsquo;\u00e9diteur de blocs WordPress (Gutenberg) et l&rsquo;extension du script de cr\u00e9ation de bloc pour permettre des points de terminaison suppl\u00e9mentaires. Dans ce&#8230;<\/p>\n","protected":false},"author":1,"featured_media":223685,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[915,893,717,936],"tags":[1167],"class_list":["post-228718","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-autre","category-code-2","category-developpeur","category-gutenberg-3","tag-affiai-fr"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/228718","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=228718"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/228718\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media\/223685"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media?parent=228718"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/categories?post=228718"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/tags?post=228718"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}