Solução de problemas

Resumo

A maioria dos problemas do ZenBlocks pode ser resolvida com Clear CSS Cache, reativando o plugin e limpando o cache do navegador. A seguir estão os passos de verificação para cada caso.

Os blocos não aparecem no painel de inserção

Procedimento de verificação

  1. Verifique se o plugin está ativo
  • Abra Plugins no painel do WordPress
  • Confirme se o ZenBlocks aparece na lista e está ativo
  • Se estiver desativado, clique em Ativar
  1. Verifique a versão do WordPress
  • Confira a versão em Painel > Atualizações
  • O ZenBlocks requer WordPress 6.0 ou superior
  1. Verifique se o Classic Editor está ativo
  • Se o plugin Classic Editor estiver ativo, o editor de blocos pode estar desativado
  • Confirme em Configurações > Escrita que o editor padrão é o editor de blocos
  1. Verifique conflito com outros plugins
  • Desative temporariamente todos os outros plugins e deixe apenas o ZenBlocks ativo
  • Se o bloco aparecer, reative os outros plugins um a um para identificar o conflito

O painel de configurações não abre ou não aparece

Procedimento de verificação

  1. Confirme que o bloco está selecionado
  • Clique no bloco para selecioná-lo
  • Verifique se uma borda azul aparece ao redor do bloco
  1. Verifique se a barra lateral está visível
  • Clique no ícone Settings (engrenagem) no canto superior direito do editor
  • Confirme que a aba Block no topo da barra lateral está selecionada
  1. Verifique erros nas ferramentas de desenvolvedor do navegador
  • Abra as ferramentas de desenvolvedor do navegador (F12)
  • Veja se existem erros JavaScript na aba Console
  • Se houver erro, publique-o no fórum de suporte com uma captura de tela

Os estilos não são aplicados no front-end

Procedimento de verificação

  1. Limpe o cache CSS
  • Abra Settings > ZenBlocks no painel do WordPress
  • Clique em Clear CSS Cache
  • Salve novamente a página afetada
  1. Limpe o cache do navegador
  • Limpe o cache do navegador
  • Ou force o recarregamento com Ctrl+Shift+R / Cmd+Shift+R
  1. Salve a página novamente
  • Abra a página afetada no editor
  • Clique em Atualizar
  • O arquivo CSS será regenerado
  1. Verifique o cache no servidor
  • Se estiver usando plugins de cache como WP Super Cache, W3 Total Cache ou LiteSpeed Cache, limpe também esse cache
  • Se usar um CDN como Cloudflare, faça purge do cache do CDN também

Observação: O cache CSS do ZenBlocks fica em /wp-content/uploads/zenblocks/. Verifique se esse diretório tem permissão de escrita.

As configurações responsivas não são refletidas

Procedimento de verificação

  1. Verifique se existem valores por dispositivo
  • Em cada painel de configurações da barra lateral, clique no ícone de dispositivo (PC / MD / TB / SP)
  • Se um dispositivo específico estiver sem valor, o valor de PC será usado como fallback
  1. Verifique os breakpoints
  • Confira os valores em Settings > ZenBlocks
  • Confirme se os valores personalizados estão como planejado
  1. Limpe o cache CSS
  • O CSS responsivo fica em cache, então o cache precisa ser limpo após qualquer mudança
  • Clique em Settings > ZenBlocks > Clear CSS Cache
  1. Verifique no modo responsivo do navegador
  • Abra as ferramentas de desenvolvedor do navegador (F12)
  • Ajuste a largura na barra de dispositivos para corresponder ao breakpoint
  • Confira a exibição em cada breakpoint

A animação não funciona

Procedimento de verificação

  1. Verifique se o recurso Pro está ativo (animação é um recurso Pro)
  • Confirme em Settings > ZenBlocks que a licença está Active
  • Verifique se o plugin ZenBlocks Pro está ativo
  1. Verifique as configurações de animação
  • Abra o painel Animation Settings na barra lateral
  • Confirme que o tipo de animação não está definido como None
  • Verifique se Duration não está em 0
  1. Verifique no front-end
  • A animação pode ser pré-visualizada no editor, mas a verificação final deve ser feita no front-end
  • Recarregue a página para confirmar a reprodução
  1. Verifique conflito com transitions
  • Se animação e transition estiverem ativas ao mesmo tempo, pode ocorrer comportamento inesperado
  • Veja se há um aviso no painel de transition

O efeito hover não funciona

Procedimento de verificação

  1. Verifique se a aba Hover possui valores
  • Selecione a aba Hover no painel de configurações da barra lateral
  • Confirme que as propriedades que deseja alterar possuem valores configurados
  1. Verifique as configurações de transition
  • Verifique se Duration no painel de transition não é 0ms
  • Valor recomendado: de 200ms a 400ms
  1. Limpe o cache CSS e verifique novamente

Para mais detalhes, consulte FAQ do buttonBasic: o estilo hover não é refletido.

É exibido um erro de validação do bloco

Procedimento de verificação

  1. Atualize o plugin para a versão mais recente
  • Atualize o ZenBlocks em Plugins > Atualizações no painel do WordPress
  1. Recupere o bloco
  • Clique em Attempt to recover block na mensagem de erro
  • Após a recuperação, revise as configurações e salve a página novamente
  1. Se não resolver
  • Exclua o bloco e crie um novo
  • Se ele tiver sido salvo como design personalizado, aplique um preset ao novo bloco para restaurá-lo

Observação: Erros de validação podem ocorrer quando o formato de saída HTML muda após uma atualização do plugin. A recuperação do bloco ajusta automaticamente o conteúdo ao novo formato.

Se o problema continuar

Se as etapas acima não resolverem o problema, publique um tópico no fórum de suporte do WordPress.org.

Inclua as seguintes informações:

  • Versão do WordPress
  • Versão do PHP
  • Nome do tema em uso
  • Versão do ZenBlocks / ZenBlocks Pro
  • Passos para reproduzir o problema
  • Captura de tela ou gravação de tela
  • Mensagens de erro exibidas na Console das ferramentas de desenvolvedor do navegador