# Como corrigir o erro do widget Advanced Accordion no Essential Addons

O Essential Addons accordion não funciona quando o elemento Advanced Accordion esta desativado na tela de Elementos do plugin, quando ha conflito com cache ou JavaScript de outro plugin, ou quando o Essential Addons e o Elementor estão desatualizados, impedindo o widget de aparecer no editor ou de abrir no frontend.

## O que é Essential Addons accordion que não funciona?

O Essential Addons accordion e o widget Advanced Accordion (EA Advanced Accordion), um dos elementos de conteúdo do plugin Essential Addons for Elementor. Ele monta blocos retrateis de pergunta e resposta dentro do Elementor e ainda oferece, na própria documentação do plugin, uma opção de FAQ Schema para gerar dados estruturados de FAQPage a partir dos itens do accordion. Quando funciona, você arrasta o widget no editor, preenche os títulos e o conteúdo de cada item e o visitante expande cada seção com um clique.

O problema aparece de três formas: o widget some da aba de elementos do editor do Elementor e não pode ser inserido; o accordion já inserido não expande ao clicar no frontend, ficando travado aberto ou fechado; ou o FAQ Schema deixa de ser emitido. Na prática, isso quase sempre vem de um elemento desativado na tela de Elementos do Essential Addons, de versões incompativeis entre Essential Addons e Elementor, ou de cache e conflito de JavaScript que impedem o script do accordion de carregar.

## Como identificar

- O widget 'Advanced Accordion' não aparece na busca de elementos do painel do Elementor, mesmo com o Essential Addons ativo.
- O accordion abre normalmente no editor do Elementor, mas no frontend os itens não expandem ao clicar e ficam todos travados.
- No console do navegador surge um erro de JavaScript como "Uncaught TypeError" ou "$ is not a function" ao carregar a página com o accordion.
- O accordion exibe todos os itens abertos ao mesmo tempo, sem o efeito de retrair, como se o CSS e o JS do widget não tivessem sido carregados.
- O FAQ Schema configurado no widget não aparece nos dados estruturados da página ao testar a URL no Rich Results Test do Google.

**Antes de começar:** Antes de atualizar plugins, alterar as otimizacoes do cache ou trocar de tema em producao, faca um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para poder reverter caso o layout da página quebre.

## Como prevenir

- Mantenha o Essential Addons for Elementor e o Elementor sempre atualizados juntos, validando antes em staging para acompanhar mudancas na API de widgets.
- Deixe ativados na tela de Elementos apenas os widgets que você usa, mas confira a lista após cada atualização do plugin para garantir que o Advanced Accordion continue ligado.
- Ao configurar o plugin de cache, exclua os scripts do Essential Addons da minificacao e do adiamento de JavaScript para não quebrar widgets interativos como o accordion.
- Teste o FAQ Schema do Advanced Accordion no Rich Results Test do Google sempre que publicar uma página nova com o widget, para confirmar que os dados estruturados estão sendo emitidos.

Erros relacionados

- [Como corrigir o widget Post Grid que não exibe posts no Essential Addons](https://full.services/wp-fixer/corrigir-post-grid-essential-addons/)
- [Como corrigir o widget Data Table que não carrega dados no Essential Addons](https://full.services/wp-fixer/corrigir-data-table-essential-addons/)
- [Como corrigir o erro de licença no Essential Addons for Elementor](https://full.services/wp-fixer/corrigir-erro-licenca-essential-addons/)

## Causa

- O elemento Advanced Accordion esta desligado na tela Essential Addons -> Elements (Elementos), onde cada widget do plugin tem um toggle próprio; com o toggle desativado o widget some da aba de elementos do Elementor.
- O Essential Addons ou o Elementor estão em versões incompativeis: uma atualização do Elementor que muda a API de widgets sem a versão correspondente do Essential Addons faz o registro do Advanced Accordion falhar.
- Um plugin de cache (como o WP Rocket) ou de minificacao concatenou ou adiou o JavaScript do accordion, e o script que controla a abertura dos itens não roda no frontend, deixando o accordion travado.
- Outro plugin ou o tema carrega uma versão conflitante de jQuery ou um erro de JavaScript anterior interrompe a fila de scripts antes do script do Advanced Accordion inicializar.
- O CSS do Essential Addons não foi carregado na página porque o recurso de 'Load assets only when needed' (carregar recursos sob demanda) do plugin não detectou o widget, deixando o accordion sem estilo nem comportamento de retrair.

## Como resolver

1. Reative o elemento Advanced Accordion na tela de Elementos: Abra a tela de Elementos do Essential Addons no painel e confirme que o toggle do Advanced Accordion esta ligado. Esse e o motivo mais comum do widget sumir da aba de elementos do Elementor, já que cada elemento do plugin pode ser ativado ou desativado individualmente.

```
Painel WP -> Essential Addons -> Elements (Elementos)
Localize 'Advanced Accordion' na lista de elementos de conteúdo
Ligue o toggle do elemento e clique em Save Settings (Salvar)
```

2. Atualize o Essential Addons e o Elementor: Garanta que o Essential Addons for Elementor e o Elementor estejam na versão estavel mais recente. Versões incompativeis entre os dois são uma causa frequente de widgets que não registram no editor após uma atualização.

```
Painel WP -> Plugins -> Plugins Instalados
Atualize o 'Essential Addons for Elementor' e o 'Elementor' para a versão mais recente
Reabra o editor do Elementor e procure novamente pelo widget Advanced Accordion
```

3. Limpe o cache do site e do plugin de cache: Se o accordion aparece no editor mas não abre no frontend, limpe o cache da página e o cache do plugin de cache, pois um JavaScript antigo em cache impede o script atual do accordion de carregar.

```
Painel WP -> Essential Addons -> Tools -> Clear Cache (se disponível)
Limpe o cache do seu plugin de cache (ex.: WP Rocket -> Settings -> Clear Cache)
Recarregue a página do frontend com Ctrl+Shift+R para ignorar o cache do navegador
```

4. Desligue a minificacao e o adiamento de JavaScript do accordion: No plugin de cache, desative temporariamente a concatenacao, a minificacao e o 'delay JavaScript' para confirmar se o script do Advanced Accordion volta a rodar. Se voltar, adicione o script do Essential Addons a lista de exclusoes em vez de manter a otimização desligada.

```
WP Rocket -> File Optimization -> desmarque 'Combine JavaScript files' e 'Minify JavaScript files'
WP Rocket -> File Optimization -> desative 'Delay JavaScript execution' e teste o accordion
Se resolver, reative a otimização e adicione o handle do Essential Addons as exclusoes
```

5. Isole conflito de plugin ou tema: Se o accordion ainda não abre no frontend, desative os outros plugins um a um e troque para um tema padrão, recarregando a página a cada teste, para identificar o plugin ou tema que interrompe o JavaScript antes do accordion inicializar.

```
Painel WP -> Plugins -> desative os demais plugins um a um (mantenha Elementor e Essential Addons ativos)
Painel WP -> Aparencia -> Temas -> ative um tema padrão (ex.: Hello Elementor)
Abra o console do navegador (F12 -> Console) e recarregue a página a cada teste para ver o erro de JavaScript
```


## Código

```javascript
// Reinicializa o EA Advanced Accordion quando o script foi adiado pelo cache.
// Cole no rodape do tema (footer.php) ou em um snippet de JS apos o jQuery.
jQuery(function ($) {
  function eaInitAccordion() {
    $('.eael-accordion-list .eael-accordion-header').off('click.eaFix').on('click.eaFix', function () {
      var $item = $(this).closest('.eael-accordion-list');
      $item.toggleClass('show-content');
      $item.find('.eael-accordion-content').slideToggle(300);
    });
  }
  // roda no load e tambem apos o lazy/delay de JS do plugin de cache
  eaInitAccordion();
  $(window).on('load', eaInitAccordion);
});
```

## Perguntas frequentes

### Por que o widget Advanced Accordion não aparece no painel do Elementor

Quase sempre o elemento esta desativado na tela Essential Addons -> Elements, onde cada widget do plugin tem um toggle próprio. Reabra essa tela, ligue o toggle do Advanced Accordion, salve as configurações e o widget volta a aparecer na busca de elementos do editor.

### O Essential Addons accordion abre no editor mas não no frontend, o que fazer

Isso costuma ser cache ou minificacao de JavaScript. Limpe o cache do site e do plugin de cache, recarregue a página ignorando o cache do navegador e, se persistir, desative temporariamente a concatenacao e o delay de JavaScript para confirmar que o script do accordion voltou a rodar.

### Como ativar o Advanced Accordion no Essential Addons

Va em Essential Addons -> Elements no painel do WordPress, localize o Advanced Accordion na lista de elementos de conteúdo, ligue o toggle correspondente e clique em salvar. So depois ele fica disponível para arrastar no editor do Elementor.

### O FAQ Schema do Advanced Accordion não esta funcionando

A documentação do Essential Addons confirma que o Advanced Accordion oferece uma opção de FAQ Schema para gerar dados estruturados. Ative essa opção no widget, salve a página e valide a URL no Rich Results Test do Google para confirmar que o FAQPage esta sendo emitido.

### Uma atualização do Elementor quebrou o Advanced Accordion, como resolver

Atualize também o Essential Addons para a versão estavel mais recente, pois versões incompativeis entre os dois fazem o widget falhar no registro do editor. Mantenha sempre os dois plugins atualizados em conjunto e teste em staging antes de aplicar em producao.

### O WP Rocket pode quebrar o accordion do Essential Addons

Sim. A combinacao, a minificacao e o delay de JavaScript do WP Rocket podem impedir o script do accordion de rodar no frontend. Desative essas otimizacoes para testar e, se resolverem, adicione o script do Essential Addons a lista de exclusoes em vez de manter a otimização desligada.

### Como saber se o problema e do Essential Addons ou de outro plugin

Desative os demais plugins um a um, mantendo Elementor e Essential Addons ativos, e troque para um tema padrão como o Hello Elementor, recarregando a página a cada teste. Se o accordion voltar a funcionar, reative os itens até identificar o que interrompe o JavaScript.

**Fonte:** [Essential Addons for Elementor - Advanced Accordion (documentacao oficial)](https://essential-addons.com/docs/advanced-accordion/)