allowed_block_types<\/code>. Este filtro fornece dois par\u00e2metros; uma matriz de todos os blocos e o objeto post. Tudo o que precisamos fazer \u00e9 gerenciar o array antes de devolv\u00ea-lo. E como tamb\u00e9m obtemos o objeto de postagem no filtro, tamb\u00e9m podemos adicionar regras por tipo de postagem ou outras informa\u00e7\u00f5es meta de postagem.<\/p>\nA matriz de blocos consiste em sequ\u00eancias de nomes com namespace do bloco. Todos os blocos no WordPress requerem um namespace prefixado antes do nome do bloco. Para os blocos principais do WordPress o namespace \u00e9 ” core\/<\/code>" e para os blocos de incorpora\u00e7\u00e3o do WordPress o namespace \u00e9 ” “. Por<\/a>core-embed\/<\/code> exemplo, o bloco de cabe\u00e7alho tem o nome ” core\/heading<\/code>" neste array. para acessar e analisar os blocos de uma postagem<\/a>.<\/p>\nAqui est\u00e1 um exemplo r\u00e1pido de como usar o filtro para remover todos os blocos, exceto o par\u00e1grafo. Isso se aplicar\u00e1 a todos os tipos de postagem.<\/p>\n
add_filter('allowed_block_types', function($block_types, $post) {\n return ['core\/paragraph'];\n}, 10, 2);<\/code><\/pre>\nSe voc\u00ea adicionar este c\u00f3digo no arquivo do seu tema functions.php<\/code>ou plugin, o resultado \u00e9 que o Gutenberg n\u00e3o permite nenhum outro bloco al\u00e9m do par\u00e1grafo. Voc\u00ea nem poder\u00e1 ver outros blocos, nem tentar atra\u00ed-los digitando ” \/<\/code>” na postagem (atalho de bloco) ou procurando por eles.<\/p>\n<\/p>\nPodemos definir os blocos que queremos manter ou remover por tipo de postagem. N\u00f3s simplesmente verificamos a propriedade post_type<\/code>no objeto post. No exemplo de c\u00f3digo abaixo, definimos um novo array dos blocos que queremos permitir e adicionamos essa regra apenas para o tipo de postagem personalizado ‘ book<\/code>‘.<\/p>\nadd_filter('allowed_block_types', function($block_types, $post) {\n $allowed = [\n 'core\/paragraph',\n 'core\/heading',\n 'core\/image'\n ];\n if ($post->post_type == 'book') {\n return $allowed;\n }\n return $block_types;\n}, 10, 2);<\/code><\/pre>\nCom o c\u00f3digo acima voc\u00ea obt\u00e9m todos os blocos ao editar posts e p\u00e1ginas, mas ao editar o tipo de post personalizado ‘ book<\/code>‘, voc\u00ea s\u00f3 pode adicionar par\u00e1grafos, t\u00edtulos e imagens \u00fanicas.<\/p>\nUse sua imagina\u00e7\u00e3o para adicionar suas pr\u00f3prias regras. Como temos o objeto post, podemos acessar a maioria das informa\u00e7\u00f5es que precisar\u00edamos. Talvez voc\u00ea precise limitar as op\u00e7\u00f5es de bloco por um valor meta p\u00f3s? Por exemplo, por modelo de p\u00e1gina escolhido, categoria de postagem escolhida ou outra coisa.<\/p>\n
Lista de permiss\u00f5es<\/h3>\n
At\u00e9 onde posso ver, voc\u00ea s\u00f3 pode listar blocos (decidir quais remover, em vez de decidir qual manter) cancelando o registro dos blocos em um determinado ponto. E voc\u00ea tem que fazer isso com Javascript e n\u00e3o PHP.<\/p>\n
N\u00e3o entrarei em detalhes sobre isso, mas voc\u00ea precisar\u00e1 enfileirar um arquivo Javascript carregado init<\/code>ou enqueue_block_editor_assets<\/code>gancho, com wp-dom-ready<\/code>e wp-blocks<\/code>como depend\u00eancia. Dentro do script voc\u00ea pode configurar uma vari\u00e1vel daquela(s) que deseja remover, seguindo as mesmas regras para namespaces e nomes de blocos acima. E para cada nome de bloco voc\u00ea chama a fun\u00e7\u00e3o unregisterBlockType()<\/code>do wp.blocks<\/code>pacote. Normalmente, voc\u00ea precisaria fazer isso dentro de uma fun\u00e7\u00e3o wp.domReady()<\/code>para garantir que a ordem de carregamento do script esteja correta.<\/p>\nAlgo assim:<\/p>\n
var removeBlocks = [\n 'core\/paragraph',\n 'core\/heading',\n 'core\/image'\n];\n\u00a0\nwp.domReady(function() {\n removeBlocks.forEach(function(blockName) {\n wp.blocks.unregisterBlockType(blockName);\n });\n});<\/code><\/pre>\nA remo\u00e7\u00e3o de tipos de blocos \u00e9 uma forma de controlar blocos no Gutenberg. Vamos dar uma olhada na outra maneira, talvez mais divertida, de controlar blocos: templates de blocos.<\/p>\n
Modelos de bloco<\/h2>\n
Outra maneira de controlar os blocos do Gutenberg no WordPress \u00e9 usando modelos de bloco. O WordPress possui uma funcionalidade que permite preencher novos posts com um conjunto de blocos predefinidos. Isso pode ser \u00fatil para ajudar os autores, mostrando a eles uma sugest\u00e3o de estrutura de bloco. Voc\u00ea tamb\u00e9m pode optar por bloquear esses blocos pr\u00e9-preenchidos, n\u00e3o permitindo que os autores reorganizem ou adicionem outros blocos. Isso \u00e9 \u00fatil quando voc\u00ea deseja que as postagens tenham uma estrutura e design espec\u00edficos \u2013 por exemplo, certificando-se de que todas as postagens desse tipo de postagem tenham suas informa\u00e7\u00f5es estruturadas exatamente da mesma maneira.<\/p>\n
Podemos adicionar modelos de bloco com um novo par\u00e2metro \u00e0 [register_post_type](https:\/\/developer.wordpress.org\/reference\/functions\/register_post_type\/)()<\/code>fun\u00e7\u00e3o que \u00e9 usada para registrar tipos de postagem personalizados (nota: o novo par\u00e2metro ainda n\u00e3o foi adicionado \u00e0 documenta\u00e7\u00e3o). Voc\u00ea tamb\u00e9m pode adicionar ou ajustar os par\u00e2metros em tipos de postagem existentes, como postagens e p\u00e1ginas – veja abaixo como.<\/p>\nO novo par\u00e2metro para register_post_type()<\/code>\u00e9 ‘ template<\/code>‘. Como valor para ‘ template<\/code>‘ voc\u00ea precisa fornecer um array de blocos. Cada bloco deve ser um array tamb\u00e9m. No m\u00ednimo, voc\u00ea precisa fornecer o primeiro elemento da matriz; o nome do bloco (por exemplo core\/paragraph<\/code>, ). Voc\u00ea pode opcionalmente adicionar um segundo elemento de array para atributos e um terceiro elemento de array para blocos aninhados (por exemplo, Cover, Columns blocks). Ficar\u00e1 mais claro quando voc\u00ea vir o c\u00f3digo.<\/p>\nVamos come\u00e7ar simples. Suponha que tenhamos uma register_post_type()<\/code>chamada de fun\u00e7\u00e3o para registrar um tipo de postagem personalizado ‘ book<\/code>‘. Queremos pr\u00e9-preencher todas as novas postagens desse tipo de postagem com um bloco de par\u00e1grafo com um espa\u00e7o reservado informando ao autor o que ele deve escrever.<\/p>\nadd_action('init', function() {\n register_post_type('book', [\n 'label' => __('Books', 'txtdomain'),\n 'public' => true,\n ...\n 'template' => [\n ['core\/paragraph', ['placeholder' => __('Write your intro here...', 'txtdomain')]],\n ],\n ]);\n});<\/code><\/pre>\nObserve que a matriz de atributos (com ‘placeholder’) \u00e9 opcional. Agora, com este par\u00e2metro ‘template’ sempre que criarmos novos posts, ele ser\u00e1 criado com um bloco de par\u00e1grafo que possui o placeholder “Escreva sua introdu\u00e7\u00e3o aqui\u2026”.<\/p>\n
Vejamos um exemplo mais complicado: blocos aninhados. Digamos que queremos adicionar um bloco de capa que tenha um bloco de t\u00edtulo, um par\u00e1grafo e um bot\u00e3o dentro dele, alinhado ao centro. O t\u00edtulo e o par\u00e1grafo ter\u00e3o um espa\u00e7o reservado:<\/p>\n
'template' => [\n ['core\/cover', ['align' => 'full', 'overlayColor' => 'blue-profile'], [\n ['core\/heading', ['align' => 'center', 'placeholder' => __('Call to action title', 'txtdomain')]],\n ['core\/paragraph', ['align' => 'center', 'placeholder' => __('Your text here', 'txtdomain')]],\n ['core\/button', ['align' => 'center']]\n ]],\n],<\/code><\/pre>\nA imagem abaixo mostra o que obteremos quando criarmos novas publica\u00e7\u00f5es de livros. Parece menos intimidante do que uma tela em branco, certo?<\/p>\n
![\"Como](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152040-61e4d330dc012.png\")
<\/a><\/p>\nTenha em mente que os atributos s\u00e3o diferentes em cada tipo de bloco e tamb\u00e9m podem diferir em sua configura\u00e7\u00e3o. No exemplo de c\u00f3digo acima, adiciono dois atributos ao bloco Cover; bloqueie o alinhamento para “Full Width” e sobreponha a cor a uma cor predefinida de uma paleta de cores personalizada.<\/p>\n
![\"Como](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-152040-61e4d33596f0b.gif\")
<\/a><\/p>\n