{"id":228762,"date":"2022-10-16T12:36:00","date_gmt":"2022-10-16T09:36:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=228762"},"modified":"2022-11-09T04:11:05","modified_gmt":"2022-11-09T01:11:05","slug":"registre-um-padrao-de-bloco-no-wordpress-block-editor-gutenberg","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/registre-um-padrao-de-bloco-no-wordpress-block-editor-gutenberg\/","title":{"rendered":"Registre um padr\u00e3o de bloco no WordPress Block Editor (Gutenberg)"},"content":{"rendered":"\n<p>Padr\u00f5es de bloco no editor de blocos do WordPress (Gutenberg) s\u00e3o um recurso poderoso que permite criar layouts variados com muito pouco esfor\u00e7o.<\/p>\n<p>Usando <code>register_block_pattern<\/code>voc\u00ea pode criar rapidamente um padr\u00e3o de bloco para voc\u00ea ou seus clientes.<\/p>\n<h2>Pr\u00e9-requisitos<\/h2>\n<ul>\n<li>Instala\u00e7\u00e3o do WordPress<\/li>\n<li>Editor de c\u00f3digo<\/li>\n<\/ul>\n<h2>Crie seu padr\u00e3o de bloco<\/h2>\n<p>Voc\u00ea cria padr\u00f5es de blocos a partir dos blocos registrados em seu site. Estes podem ser blocos principais ou qualquer n\u00famero de blocos personalizados ou de terceiros.<\/p>\n<p>Comece usando o editor do WordPress para criar um layout de bloco. Voc\u00ea pode usar as configura\u00e7\u00f5es para tornar isso t\u00e3o complexo ou t\u00e3o simples quanto desejar.<\/p>\n<p>Neste exemplo, vamos mant\u00ea-lo simples e simplesmente criar um padr\u00e3o de bloco com as seguintes estruturas:<\/p>\n<ul>\n<li>Bloco de grupo\n<ul>\n<li>Cabe\u00e7alho<\/li>\n<li>Par\u00e1grafo<\/li>\n<li>Colunas\n<ul>\n<li>Coluna 1\n<ul>\n<li>Cabe\u00e7alho<\/li>\n<li>Par\u00e1grafo<\/li>\n<\/ul>\n<\/li>\n<li>Coluna 2\n<ul>\n<li>Cabe\u00e7alho<\/li>\n<li>Par\u00e1grafo<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>Depois de construir seu padr\u00e3o de bloco, basta copiar o c\u00f3digo que foi gerado para voc\u00ea.<\/p>\n<p>Copie o c\u00f3digo do padr\u00e3o de bloco<\/p>\n<p>Para fazer isso, v\u00e1 para os tr\u00eas pontos no canto superior direito do editor (op\u00e7\u00f5es rotuladas) e selecione &#8216;Editor de c\u00f3digo&#8217;. Isso mostrar\u00e1 o HTML por tr\u00e1s do padr\u00e3o de bloco que voc\u00ea acabou de criar.<\/p>\n<p>Copie este c\u00f3digo em sua \u00e1rea de transfer\u00eancia.<\/p>\n<h2>Registre o padr\u00e3o de bloco<\/h2>\n<p>Cole este c\u00f3digo do editor de blocos em seu editor de c\u00f3digo. Se voc\u00ea n\u00e3o tiver certeza de onde, poder\u00e1 usar o <code>functions.php<\/code>do seu tema.<\/p>\n<p>Certifique-se de pass\u00e1-lo para uma vari\u00e1vel colocando aspas simples (<code>'<\/code>) ao redor do texto colado, assim:<\/p>\n<pre><code>$block_pattern_content = '\n&lt;div class=\"wp-block-group\"&gt;&lt;div class=\"wp-block-group__inner-container\"&gt;\n&lt;h2&gt;Example Block Pattern&lt;\/h2&gt;\n\n&lt;p&gt;Lorem ipsum dolor sit amet labore cras venenatis.&lt;\/p&gt;\n\n&lt;div class=\"wp-block-columns\"&gt;\n&lt;div class=\"wp-block-column\"&gt;\n&lt;h3&gt;Sub Heading 1&lt;\/h3&gt;\n\n&lt;p&gt;Lorem ipsum dolor sit amet id erat aliquet diam ullamcorper tempus massa eleifend vivamus.&lt;\/p&gt;\n&lt;\/div&gt;\n\n&lt;div class=\"wp-block-column\"&gt;\n&lt;h3&gt;Sub Heading 2&lt;\/h3&gt;\n\n&lt;p&gt;Morbi augue cursus quam pulvinar eget volutpat suspendisse dictumst mattis id.&lt;\/p&gt;\n&lt;\/div&gt;\n&lt;\/div&gt;\n&lt;\/div&gt;&lt;\/div&gt;\n';\n<\/code><\/pre>\n<p>Voc\u00ea pode precisar fazer alguns escapes dos caracteres, dependendo da complexidade do seu padr\u00e3o de bloco.<\/p>\n<p>Em seguida, precisamos passar isso para a <code>register_block_pattern<\/code>fun\u00e7\u00e3o:<\/p>\n<pre><code>register_block_pattern(\n    'wholesomecode\/example-block-pattern',\n    [\n        'categories'    =&gt; [\n            'text',\n        ],\n        'content'       =&gt; $block_pattern_content,\n        'description'   =&gt; 'An example block pattern',\n        'keywords'      =&gt; 'example',\n        'title'         =&gt; 'Example Block Pattern',\n        'viewportWidth' =&gt; 800,\n    ],\n);\n<\/code><\/pre>\n<p>\u00c9 isso, o padr\u00e3o de bloco \u00e9 registrado.<\/p>\n<h3>Quebrar<code>register_block_pattern<\/code><\/h3>\n<ul>\n<li><strong>Namespace<\/strong> \u2014 (<code>wholesomecode\/example-block-pattern<\/code>) \u00e9 o namespace do padr\u00e3o de bloco. Certifique-se de que isso seja exclusivo para seu padr\u00e3o de bloco. Se precisarmos cancelar o registro do padr\u00e3o de bloco, esta \u00e9 a string que precisaremos.<\/li>\n<li><strong>Categorias<\/strong> \u2014 Esta \u00e9 a categoria do padr\u00e3o de bloco em que o padr\u00e3o de bloco aparecer\u00e1, quando inserirmos nosso padr\u00e3o de bloco. Tamb\u00e9m podemos <a href=\"https:\/\/wholesomecode.ltd\/#custom-block-pattern-category\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">adicionar nossas pr\u00f3prias categorias<\/a>.<\/li>\n<li><strong>Conte\u00fado<\/strong> \u2014 Este \u00e9 o HTML que gera o padr\u00e3o de bloco. Este exemplo usa a vari\u00e1vel que criamos no editor.<\/li>\n<li><strong>Descri\u00e7\u00e3o<\/strong> \u2014 Uma descri\u00e7\u00e3o do padr\u00e3o de bloco.<\/li>\n<li><strong>Palavras<\/strong> -chave \u2014 Palavras-chave que podem ser usadas para pesquisar o padr\u00e3o de bloco.<\/li>\n<li><strong>T\u00edtulo<\/strong> \u2014 O t\u00edtulo do padr\u00e3o de bloco.<\/li>\n<li><strong>Largura<\/strong> da janela de visualiza\u00e7\u00e3o \u2014 A janela de visualiza\u00e7\u00e3o do padr\u00e3o de bloco, usada para a \u00e1rea de visualiza\u00e7\u00e3o.<\/li>\n<\/ul>\n<h2>Insira o padr\u00e3o de bloco<\/h2>\n<p>Para inserir o padr\u00e3o de bloco, basta usar o sinal de mais no canto superior esquerdo do editor e selecionar os padr\u00f5es de bloco.<\/p>\n<p>Selecione a categoria na qual voc\u00ea registrou seu padr\u00e3o e ela deve aparecer.<\/p>\n<p>Inserindo o padr\u00e3o de bloco<\/p>\n<p>Alternativamente, voc\u00ea pode pesquisar pelas palavras-chave que voc\u00ea registrou.<\/p>\n<p>Para cadastrar uma categoria de bloco, basta utilizar a <code>register_block_pattern_category<\/code>fun\u00e7\u00e3o.<\/p>\n<pre><code>register_block_pattern_category(\n    'my-client',\n    [\n        'label' =&gt; esc_html__( 'My Client Patterns', 'wholesome-plugin' ),\n    ]\n);\n<\/code><\/pre>\n<p>Ent\u00e3o voc\u00ea pode usar a categoria que voc\u00ea acabou de registrar em seu c\u00f3digo de padr\u00e3o de bloco, assim:<\/p>\n<pre><code>register_block_pattern(\n    'wholesomecode\/example-block-pattern',\n    [\n        'categories'    =&gt; [\n            'my-client',\n        ],\n        'content'       =&gt; $block_pattern_content,\n        'description'   =&gt; 'An example block pattern',\n        'keywords'      =&gt; 'example',\n        'title'         =&gt; 'Example Block Pattern',\n        'viewportWidth' =&gt; 800,\n    ],\n);\n<\/code><\/pre>\n<p>Agora, quando voc\u00ea encontrar seu padr\u00e3o de bloco, ele estar\u00e1 localizado em sua categoria personalizada:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168978-61e7f9e9b9076.png\" alt=\"Registre um padr\u00e3o de bloco no WordPress Block Editor (Gutenberg)\" \/>Categoria de padr\u00e3o de bloco personalizado<\/p>\n<p>Agora voc\u00ea pode agrupar todos os padr\u00f5es de blocos personalizados que acabou de criar para seu cliente em um s\u00f3 lugar.<\/p>\n<ul>\n<li>Precisa de algo mais est\u00e1tico? Tente <a href=\"https:\/\/wholesomecode.ltd\/guides\/register-block-template-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">registrar um modelo de bloco<\/a> em vez disso<\/li>\n<li>Precisa de algo que se aplique a bloqueios infantis? Tente <a href=\"https:\/\/wholesomecode.ltd\/guides\/template-innerblocks-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">registrar um modelo do InnerBlocks<\/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>Padr\u00f5es de bloco no editor de blocos do WordPress (Gutenberg) s\u00e3o um recurso poderoso que permite criar layouts variados com muito pouco esfor\u00e7o.<\/p>\n","protected":false},"author":1,"featured_media":220451,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[898,722,941,806,816,867],"tags":[1170],"class_list":["post-228762","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-codigo-2","category-desenvolvedor","category-gutenberg-8","category-php-8","category-plug-ins","category-wordpress-8","tag-affiai-pt-pt"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/228762","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=228762"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/228762\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media\/220451"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=228762"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/categories?post=228762"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/tags?post=228762"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}