ACF PRO Gutenberg: corrigir incompatibilidade no editor

Tipo Page Builders

Nome do erro Incompatibilidade do ACF PRO com o Gutenberg EN: ACF PRO incompatible with Gutenberg editor

Severidade Atenção

Descrição A incompatibilidade do ACF PRO com o Gutenberg ocorre quando o plugin Gutenberg standalone, uma versão defasada do ACF ou um block.json mal registrado impedem que campos e ACF Blocks apareçam no editor de blocos.

Conteúdo exclusivo para membros Pro

Faça upgrade para acessar este item completo.

// ★ Conteúdo disponível para membros Pro...
// Faça upgrade para acessar este item.

Perguntas frequentes

Por que meus campos do ACF PRO sumiram do editor Gutenberg

Na maioria dos casos o grupo de campos esta com o status Active desligado ou a regra de localizacao não casa com o tipo de post editado. Em ACF -> Grupos de Campos, reative o grupo e ajuste a localizacao para o post correto.

O plugin Gutenberg standalone quebra o ACF PRO

Sim. A documentação oficial do ACF afirma que o plugin Gutenberg instalado a parte força versões experimentais da Block API ainda não suportadas pelo ACF, derrubando a renderizacao dos ACF Blocks. Desative esse plugin, pois o editor de blocos já vem no nucleo.

Qual versão do ACF e do WordPress preciso para ACF Blocks no Gutenberg

O registro de blocos por block.json foi introduzido no ACF 6.0 e exige WordPress 5.8 ou superior. Use o ACF PRO 6.0 ou mais novo e mantenha o WordPress atualizado para o bloco ser reconhecido no editor.

Por que o ACF Block mostra 'This block has encountered an error'

Esse aviso costuma indicar um block.json com apiVersion incorreta ou um render_template apontando para um arquivo que não existe. Confirme a apiVersion 2 e o caminho do template, que precisa existir na pasta do bloco.

Preciso de JavaScript para renderizar um ACF Block

Não. Os ACF Blocks são dinamicos e renderizados pelo servidor a cada carregamento por um render_template ou render_callback em PHP, sem exigir JavaScript do desenvolvedor, segundo a documentação do ACF.

Posso continuar usando acf_register_block_type em vez de block.json

Sim. Blocos registrados com acf_register_block_type continuam funcionando no ACF 6, mas o registro por block.json passou a ser o metodo recomendado. Migre quando puder para evitar problemas futuros de compatibilidade.

Como saber se o problema e do ACF ou de outro plugin

Desative os demais plugins um a um e troque para um tema padrão, recarregando o editor a cada teste. Se os campos e blocos voltarem, reative os itens até identificar o que interrompe a Block API.

Pro Grave

Como corrigir erros de exibição de produtos do WooCommerce no Elementor

Os produtos do Elementor com WooCommerce não aparecem quando o widget de Produtos carrega vazio ou a página de produto fica sem conteúdo. As causas comuns são o Source do widget apontando para uma consulta sem itens, o template do Theme Builder publicado sem condição de exibição, ou o CSS do Elementor desatualizado.

Pro Atenção

Como corrigir fontes do Google que não carregam no Elementor

O Google Fonts no Elementor não carrega quando o CSS gerado guarda referências antigas, a opção de fontes locais baixa arquivos incompletos ou o cache serve a folha antiga. O texto cai para Arial no frontend, mesmo a fonte aparecendo certa no editor.

Pro Atenção

Como corrigir o erro do Mobile Menu no Astra Pro

O Astra mobile menu não funciona quando o componente Off Canvas não esta na linha Mobile Header do Header Builder, quando o Header Breakpoint esta abaixo da largura do dispositivo ou quando o plugin de cache combina o JavaScript do Astra e quebra o Toggle Button, deixando o hamburguer sem abrir o painel no celular.

Pro Grave

Como corrigir widgets do Essential Addons quebrados pelo cache do WP Rocket

Widgets do Essential Addons param de renderizar no frontend quando o WP Rocket remove o CSS dinamico do plugin pelo Remove Unused CSS e segura o eael-general.js pelo Delay JavaScript Execution. A correção e adicionar os caminhos do eael ao Safelist de CSS, excluir o script do Delay e limpar o cache.

Pro Grave

Como corrigir a incompatibilidade entre JetThemeCore e Astra

A incompatibilidade entre JetThemeCore e Astra aparece quando o Theme Builder do Crocoblock não consegue substituir o cabeçalho, o rodape ou o body do Astra, e a página sai com o layout nativo do tema em vez do template criado. O Override theme header, body e footer parece não ter efeito e o template publicado e ignorado no front-end.

Pro Atenção

Como corrigir o conflito de estilos de formulário entre WPForms e Elementor

O conflito de estilos entre WPForms e Elementor surge quando o formulário perde a aparencia dentro de uma página do Elementor: campos sem borda, botao sem cor ou layout em coluna única. Vem da opção de estilo do WPForms desligada, do Modern Markup desativado ou do CSS global do Elementor sobrescrevendo o formulário.

Setores

Extensões

Integrações

Como corrigir a incompatibilidade do ACF PRO com o editor Gutenberg

Conteúdo exclusivo para membros Pro

Perguntas frequentes

Itens relacionados

Como corrigir erros de exibição de produtos do WooCommerce no Elementor

Como corrigir fontes do Google que não carregam no Elementor

Como corrigir o erro do Mobile Menu no Astra Pro

Como corrigir widgets do Essential Addons quebrados pelo cache do WP Rocket

Como corrigir a incompatibilidade entre JetThemeCore e Astra

Como corrigir o conflito de estilos de formulário entre WPForms e Elementor

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos