🎉 USE O CUPOM DESCONTO.FULL | 20% OFF acima de R$ 50,00

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

Time Full Services Time Full Services
Tipo Page Builders
Nome do erro Cache do WP Rocket quebra widgets do Essential Addons EN: WP Rocket cache breaking Essential Addons widgets
Severidade Grave
Descrição Widgets do Essential Addons param de renderizar no frontend quando o WP Rocket remove o CSS dinâmico 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.

O que é conflito do Essential Addons com o WP Rocket?

O conflito entre o Essential Addons e o WP Rocket acontece quando as otimizacoes de CSS e JavaScript do WP Rocket processam os arquivos que o Essential Addons gera por página. O plugin compila o estilo e o script de cada widget em arquivos próprios na pasta de uploads e os enfileira com handles como eael-general e essential-addons-elementor. Quando o Remove Unused CSS classifica esse CSS como não utilizado e o Delay JavaScript Execution segura o eael-general.js, o visitante recebe a página sem o estilo e sem a lógica dos widgets, enquanto o editor do Elementor continua mostrando tudo certo.

Como identificar

  • Widgets do Essential Addons (Post Grid, Advanced Accordion, Data Table, Testimonials) aparecem sem estilo, empilhados ou em branco no frontend, enquanto o editor do Elementor mostra o widget correto
  • Abas, acordeoes, filtros e carrosseis do Essential Addons param de responder ao clique porque o script eael-general.js não executa
  • O layout volta ao normal logo após limpar o cache do WP Rocket e quebra de novo em poucos minutos, quando o Used CSS e regenerado
  • No código-fonte da página aparece a tag inline ‘style id=wpr-usedcss’ e as folhas do plugin (eael, essential-addons-elementor) somem ou viram preload
  • No console do navegador aparece o erro ‘eael is not defined’ ou ‘localize is not defined’ porque o objeto de configuração do plugin não carregou antes do widget
  • O problema desaparece com o WP Rocket desativado e volta ao reativar o plugin
Antes de começar: Faca backup do banco antes de mexer nas otimizacoes. As configurações do WP Rocket ficam na option wp_rocket_settings e um backup permite reverter para o estado anterior caso o Used CSS regenerado piore o layout dos widgets.

Como prevenir

  • Mantenha os prefixos do Essential Addons (eael, essential-addons-elementor, .eael-) fixos no CSS Safelist do WP Rocket para que novas regeneracoes do Used CSS nunca removam o estilo dos widgets
  • Sempre que ativar ou desativar um widget em Save Default Settings, regenere os assets do plugin e so depois limpe o cache do WP Rocket, nessa ordem
  • Após atualizar o Essential Addons ou o WP Rocket, teste o frontend em uma janela anonima com cache limpo antes de considerar o deploy concluido
  • Ative o Safe Mode do WP Rocket em uma página de teste para confirmar que a quebra vem do cache antes de alterar as otimizacoes

Causa

  • A opção Remove Unused CSS (aba File Optimization) classifica o CSS por página do Essential Addons como não utilizado e o remove ao gerar o inline 'style id=wpr-usedcss', deixando os widgets sem estilo.
  • A opção Delay JavaScript Execution segura o eael-general.js e o eael scripts até a primeira interacao do usuário, e widgets interativos como Advanced Accordion e Post Grid filtravel não inicializam.
  • A opção Combine JavaScript files junta o eael-general.js com outros scripts e o objeto localizado eael_translate_text fica indefinido, gerando 'eael is not defined' no console.
  • A opção Load JavaScript Deferred adia o jQuery do qual o eael-general.js depende, e o script do plugin executa antes da dependencia, travando o widget.
  • O cache do WP Rocket foi gerado antes do Essential Addons regenerar seus assets após ativar um novo widget em Save Default Settings, servindo uma versão da página sem o CSS do widget recem-ativado.
  • A opção Minify or Combine CSS files quebra os caminhos relativos de fontes e icones dentro do CSS do Essential Addons, deixando icones de widgets como Pricing Table e Testimonials sem renderizar.

Como resolver

  1. Confirme que a causa e o WP Rocket: No painel, va em WP Rocket -> Dashboard e clique em Clear and preload cache. Se os widgets do Essential Addons voltarem ao normal e quebrarem de novo em poucos minutos, o conflito esta nas otimizacoes de CSS e JavaScript, e não no Essential Addons em si.
    Settings -> WP Rocket -> Dashboard -> Clear and preload cache
  2. Adicione os caminhos do Essential Addons ao CSS Safelist: Abra a aba de otimização de CSS, role até a área de Optimize CSS delivery e cole no campo CSS Safelist, uma por linha, as folhas e prefixos de classe do plugin. Salvar limpa e regenera o Used CSS preservando essas regras, e os widgets voltam a ter estilo.
    Settings -> WP Rocket -> File Optimization -> Optimize CSS delivery -> CSS Safelist
    eael
    essential-addons-elementor
    eael-general
    .eael-
  3. Exclua o script do Essential Addons do Delay e do Combine: Ainda em File Optimization, adicione o script do plugin na lista de exclusão do Delay JavaScript Execution e nos arquivos excluidos do Combine, para que o objeto de configuração do plugin carregue antes do widget e abas, acordeoes e filtros voltem a responder.
    Settings -> WP Rocket -> File Optimization -> Delay JavaScript Execution -> Excluded files
    /essential-addons-elementor/assets/front-end/js/view/general.min.js
    eael-general
    eael_translate_text
  4. Regenere os assets do Essential Addons e limpe o cache: Va nas configurações do Essential Addons e use a regeneracao de assets para reconstruir os arquivos por página do plugin, depois volte ao WP Rocket e limpe o cache. Recompilar no plugin antes de limpar o cache evita que o WP Rocket guarde um CSS desatualizado.
    Essential Addons -> Settings -> Save Default Settings (regenera os assets)
    Settings -> WP Rocket -> Dashboard -> Clear and preload cache
  5. Se persistir, isole a otimização culpada: Desative uma de cada vez Combine JavaScript files, Load JavaScript Deferred e Remove Unused CSS, recarregando o frontend em janela anonima com cache limpo a cada teste, até identificar qual opção quebra o widget e manter so essa desligada.
    Settings -> WP Rocket -> File Optimization (desligar uma opção por vez)
HTML
eael
essential-addons-elementor
eael-general
eael-tooltip
eael-image-comparison
.eael-
/essential-addons-elementor/assets/front-end/js/view/general.min.js
eael_translate_text

Perguntas frequentes

Por que os widgets do Essential Addons quebram so no frontend e o editor do Elementor continua normal?
O editor carrega o CSS e o JavaScript direto do plugin, sem passar pelas otimizacoes do WP Rocket. O frontend serve a versão em cache, onde o Remove Unused CSS removeu as folhas do Essential Addons e o Delay segurou o eael-general.js. Por isso a quebra aparece so para o visitante.
Preciso desativar todo o WP Rocket para os widgets do Essential Addons voltarem?
Não. Na maioria dos casos basta adicionar os prefixos eael e essential-addons-elementor ao CSS Safelist e excluir o eael-general.js do Delay JavaScript Execution. Assim você mantem o cache e o ganho de velocidade sem quebrar os widgets.
O que significa o erro eael is not defined no console depois de ativar o WP Rocket?
Esse erro aparece quando o Combine ou o Delay separam o eael-general.js do objeto de configuração que o plugin injeta inline. O widget executa antes da variavel existir e para de funcionar. Excluir o script do Combine e do Delay resolve.
Adicionei o Essential Addons ao Safelist e o layout continua quebrado, e agora?
Limpe o cache com Clear and preload cache para forcar a regeneracao do Used CSS. Se persistir, desative Combine CSS files e Remove Unused CSS um de cada vez até identificar qual opção remove o estilo dos widgets do plugin.
As abas e acordeoes do Essential Addons pararam de responder depois do WP Rocket, por que?
O Delay JavaScript Execution segura o eael-general.js até a primeira interacao do usuário. Excluir esse script da lista de Delay faz o Advanced Accordion, o Post Grid filtravel e as abas voltarem a inicializar e responder ao clique.
Preciso regenerar os assets do Essential Addons depois de mexer no cache?
Sim. Use Save Default Settings nas configurações do plugin para reconstruir os arquivos por página e so depois limpe o cache do WP Rocket. Inverter a ordem faz o WP Rocket guardar um CSS do widget que já foi recompilado.
Os icones dos widgets Pricing Table e Testimonials sumiram após o WP Rocket, como resolver?
O Combine CSS files quebra os caminhos relativos de fontes de icone dentro do CSS do Essential Addons. Desative o Combine CSS ou adicione os arquivos de fonte ao Safelist para os icones dos widgets voltarem a aparecer.
O mesmo conflito acontece com a versão Pro do Essential Addons?
Sim. Os widgets Pro como Data Table, Woo Product Grid e Event Calendar geram CSS e JavaScript próprios e sofrem o mesmo conflito. Inclua os prefixos eael e essential-addons-elementor no Safelist e exclua o script do Delay para proteger também esses widgets.

Seja PRO.

Tenha acesso a snippets de código premium — PHP, JavaScript, CSS e HTML prontos para usar em seus projetos.

Conhecer o plano Pro →

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.

Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes