{"id":228872,"date":"2022-10-18T16:43:00","date_gmt":"2022-10-18T13:43:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=228872"},"modified":"2022-11-09T04:36:13","modified_gmt":"2022-11-09T01:36:13","slug":"crie-uma-pagina-de-configuracoes-usando-os-componentes-do-wordpress-block-editor-gutenberg","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/crie-uma-pagina-de-configuracoes-usando-os-componentes-do-wordpress-block-editor-gutenberg\/","title":{"rendered":"Crie uma p\u00e1gina de configura\u00e7\u00f5es usando os componentes do WordPress Block Editor (Gutenberg)"},"content":{"rendered":"\n<p>Anteriormente, analisamos as <a href=\"https:\/\/wholesomecode.ltd\/guides\/options-settings-data-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">op\u00e7\u00f5es e configura\u00e7\u00f5es de armazenamento usando o WordPress Block Editor (Gutenberg)<\/a> e <a href=\"https:\/\/wholesomecode.ltd\/guides\/entry-points-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">expandimos o Create Block Script para permitir pontos finais extras<\/a>. Neste guia, vamos coloc\u00e1-los todos juntos para criar uma p\u00e1gina de configura\u00e7\u00f5es usando componentes do Gutenberg.<\/p>\n<p>A p\u00e1gina de configura\u00e7\u00f5es que estamos prestes a construir<\/p>\n<p>Mas primeiro, cr\u00e9dito onde o cr\u00e9dito \u00e9 devido, a inspira\u00e7\u00e3o para este guia vai para o artigo 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 &#8220;Plugin Options Page&quot; With Gutenberg Components<\/a>.<\/p>\n<h2>Pr\u00e9-requisitos<\/h2>\n<ul>\n<li>Ter seguido o guia <a href=\"https:\/\/wholesomecode.ltd\/guides\/creating-plugin-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Criando um Plugin para o Editor de Blocos do WordPress (Gutenberg)<\/a><\/li>\n<li>Seguiu o guia <a href=\"https:\/\/wholesomecode.ltd\/guides\/options-settings-data-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Using Options to Store Data in the WordPress Block Editor (Gutenberg)<\/a><\/li>\n<li>Seguiu o guia <a href=\"https:\/\/wholesomecode.ltd\/guides\/entry-points-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Adicionar pontos de entrada ao WordPress Create Block Script<\/a><\/li>\n<\/ul>\n<h2>Crie a p\u00e1gina de configura\u00e7\u00f5es em PHP<\/h2>\n<p>Seguindo os guias nos pr\u00e9-requisitos, abra o arquivo PHP raiz do plugin (neste caso <code>wholesome-plugin.php<\/code>) e adicione o seguinte:<\/p>\n<h3>Registre as configura\u00e7\u00f5es<\/h3>\n<p>Como nas <a href=\"https:\/\/wholesomecode.ltd\/guides\/options-settings-data-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">op\u00e7\u00f5es de uso para armazenar dados,<\/a> adicione as seguintes configura\u00e7\u00f5es ao arquivo:<\/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>Registre as configura\u00e7\u00f5es que acessaremos na p\u00e1gina de configura\u00e7\u00f5es. Certifique-se de definir <code>show_in_rest<\/code>para <code>true<\/code>cada um, para que possam ser acessados \u200b\u200bvia Gutenberg.<\/p>\n<h3>Registre a p\u00e1gina de configura\u00e7\u00f5es<\/h3>\n<p>Adicione o bloco de c\u00f3digo para registrar a p\u00e1gina de configura\u00e7\u00f5es:<\/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>O c\u00f3digo acima adiciona uma nova p\u00e1gina ao menu de configura\u00e7\u00f5es. Observe que tudo o que ele faz \u00e9 produzir um <code>&lt;div&gt;<\/code>, \u00e9 isso que usaremos para renderizar os componentes Gutenberg baseados em React.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168686-61e7f0058b713.png\" alt=\"Crie uma p\u00e1gina de configura\u00e7\u00f5es usando os componentes do WordPress Block Editor (Gutenberg)\" \/>Item de menu de configura\u00e7\u00f5es<\/p>\n<h3>Enfileirar recursos de administrador<\/h3>\n<p>Para o pr\u00f3ximo bloco de c\u00f3digo, precisamos ter seguido todas as etapas do guia <a href=\"https:\/\/wholesomecode.ltd\/guides\/entry-points-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Adicionar pontos de entrada ao script de cria\u00e7\u00e3o de bloco .<\/a> Certifique-se de seguir todas as etapas desse guia antes desta etapa e volte e siga o restante deste guia.<\/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>Construir a p\u00e1gina de administra\u00e7\u00e3o em JavaScript<\/h2>\n<p>Se voc\u00ea seguiu todas as etapas no guia <a href=\"https:\/\/wholesomecode.ltd\/guides\/entry-points-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Adicionar pontos de entrada ao guia Criar script de bloco<\/a>, voc\u00ea deve ter um <code>\/src\/admin.js<\/code>arquivo. Abra esse arquivo e exclua seu conte\u00fado.<\/p>\n<h3>Renderize o componente<\/h3>\n<p>Lembre-se de executar <code>npm start<\/code>em seu terminal de acordo com o <a href=\"https:\/\/wholesomecode.ltd\/guides\/entry-points-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">guia de cria\u00e7\u00e3o de plug<\/a> -ins e adicione o abaixo ao seu <code>\/src\/admin.js<\/code>arquivo.<\/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>Se voc\u00ea for para a p\u00e1gina de configura\u00e7\u00f5es no navegador, agora dever\u00e1 ver o seguinte:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168686-61e7f00682524.png\" alt=\"Crie uma p\u00e1gina de configura\u00e7\u00f5es usando os componentes do WordPress Block Editor (Gutenberg)\" \/>Renderizando componentes na tela de configura\u00e7\u00f5es<\/p>\n<h3>Adicione os campos de configura\u00e7\u00e3o<\/h3>\n<p>Lembre-se das etapas extras no guia &#8216;Usando op\u00e7\u00f5es para armazenar dados&#8217;? Bem, vamos colar tudo literalmente neste componente, ent\u00e3o voc\u00ea deve acabar com algum c\u00f3digo que se parece um pouco com isso:<\/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>Al\u00e9m da remo\u00e7\u00e3o do <code>subscribe<\/code>in <code>componentDidMount<\/code>que usamos anteriormente para salvar nesse guia e da adi\u00e7\u00e3o do bot\u00e3o, o c\u00f3digo \u00e9 praticamente copiar e colar.<\/p>\n<p>Se tudo estiver bem, nossa p\u00e1gina de configura\u00e7\u00f5es agora deve se parecer um pouco com isso:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168686-61e7f007658c6.png\" alt=\"Crie uma p\u00e1gina de configura\u00e7\u00f5es usando os componentes do WordPress Block Editor (Gutenberg)\" \/>Renderizando os campos de configura\u00e7\u00e3o<\/p>\n<p>N\u00e3o se preocupe, vamos limpar os estilos na se\u00e7\u00e3o 4 deste guia.<\/p>\n<h3>Lidar com o Salvar<\/h3>\n<p>No <code>onClick<\/code>manipulador do <code>&lt;button&gt;<\/code>componente adicione o seguinte c\u00f3digo:<\/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>Isso salvar\u00e1 nossas op\u00e7\u00f5es e configura\u00e7\u00f5es quando o bot\u00e3o for clicado. No entanto, n\u00e3o h\u00e1 indica\u00e7\u00e3o de que as op\u00e7\u00f5es foram salvas por padr\u00e3o.<\/p>\n<h3>Criar a notifica\u00e7\u00e3o<\/h3>\n<p>Para dar ao nosso usu\u00e1rio algum feedback de que as op\u00e7\u00f5es e configura\u00e7\u00f5es foram salvas, vamos implementar uma notifica\u00e7\u00e3o de &#8216;snackbar&#8217;. Esta \u00e9 a mesma notifica\u00e7\u00e3o usada na tela principal do Editor de Post que o editor de blocos usa quando o post foi salvo.<\/p>\n<p>Para adicionar isso, precisamos portar um componente principal do Gutenberg em nossa compila\u00e7\u00e3o, pois a lista de notifica\u00e7\u00f5es n\u00e3o est\u00e1 dispon\u00edvel usando as instru\u00e7\u00f5es de importa\u00e7\u00e3o usuais.<\/p>\n<p>Precisamos adicionar o seguinte c\u00f3digo no arquivo:<\/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>Em seguida, na renderiza\u00e7\u00e3o principal do <code>&lt;App&gt;<\/code>componente, adicione o seguinte antes do fechamento <code>&lt;\/Fragment&gt;<\/code>:<\/p>\n<pre><code>&lt;div className=\"wholesome-plugin__notices\"&gt;\n  &lt;Notices\/&gt;\n&lt;\/div&gt;\n<\/code><\/pre>\n<p>Por fim, adicione o seguinte ao <code>onClick<\/code>manipulador do bot\u00e3o:<\/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>Isso criar\u00e1 um pequeno pop-up &#8216;snackbar&#8217; sempre que as configura\u00e7\u00f5es forem salvas.<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168686-61e7f00850403.png\" alt=\"Crie uma p\u00e1gina de configura\u00e7\u00f5es usando os componentes do WordPress Block Editor (Gutenberg)\" \/>Notifica\u00e7\u00e3o da lanchonete em a\u00e7\u00e3o<\/p>\n<p>Eu sei, eu sei, ainda precisamos corrigir esses estilos.<\/p>\n<h3>O <code>\/src\/admin.js<\/code>arquivo completo<\/h3>\n<p>Para refer\u00eancia, aqui est\u00e1 o <code>\/src\/admin.js<\/code>c\u00f3digo completo do arquivo:<\/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>Adicione o SCSS<\/h2>\n<p>Hora de corrigir esses estilos. Basta adicionar o seguinte no <code>\/src\/admin.scss<\/code>arquivo (que voc\u00ea teria criado no guia <a href=\"https:\/\/wholesomecode.ltd\/guides\/entry-points-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Adicionar Pontos de Entrada ao Criar Script de Bloco .<\/a><\/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>Visualizando a p\u00e1gina de configura\u00e7\u00f5es<\/h2>\n<p>Aqui est\u00e1 o resultado final:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168686-61e7f0098b5d1.gif\" alt=\"Crie uma p\u00e1gina de configura\u00e7\u00f5es usando os componentes do WordPress Block Editor (Gutenberg)\" \/>A p\u00e1gina de configura\u00e7\u00f5es<\/p>\n<p>Alguns plugins t\u00eam um link de &#8216;configura\u00e7\u00f5es&#8217; na p\u00e1gina de plugins assim:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168686-61e7f00b64270.png\" alt=\"Crie uma p\u00e1gina de configura\u00e7\u00f5es usando os componentes do WordPress Block Editor (Gutenberg)\" \/>Link de configura\u00e7\u00f5es no painel da p\u00e1gina de configura\u00e7\u00f5es do plug-in<\/p>\n<p>Para conseguir isso, adicione o seguinte bloco de c\u00f3digo \u00e0 raiz do seu arquivo de plug-in (neste caso <code>wholesome-plugin.php<\/code>):<\/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\u00ea uma olhada na cria\u00e7\u00e3o <a href=\"https:\/\/wholesomecode.ltd\/guides\/template-innerblocks-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">de blocos filho aninhados com o <code>InnerBlocks<\/code>componente<\/a><\/li>\n<li>D\u00ea uma olhada no <a href=\"https:\/\/wholesomecode.ltd\/guides\/post-meta-fields-store-attributes-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">uso de meta campos post em blocos Gutenberg<\/a><\/li>\n<li>D\u00ea uma olhada na <a href=\"https:\/\/wholesomecode.ltd\/guides\/create-customizer-panel-wordpress-gutenberg-components\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">cria\u00e7\u00e3o de um painel personalizador com componentes Gutenberg<\/a><\/li>\n<\/ul>\n<p><div id=\"PostUnique_PostSource\" style=\"padding-top: 50px\">Fonte de grava\u00e7\u00e3o:  <a target=\"_blank\" rel=\"noopener nofollow\" href=\"\/\/wholesomecode.ltd\" class=\"external external_icon\">wholesomecode.ltd<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Anteriormente, analisamos as op\u00e7\u00f5es e configura\u00e7\u00f5es de armazenamento usando o WordPress Block Editor (Gutenberg) e expandimos o Create Block Script para permitir pontos finais extras. Nisso&#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":[898,722,941,920],"tags":[1170],"class_list":["post-228872","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-codigo-2","category-desenvolvedor","category-gutenberg-8","category-outro","tag-affiai-pt-pt"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/228872","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/comments?post=228872"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/228872\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media\/223685"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=228872"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/categories?post=228872"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/tags?post=228872"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}