# Como corrigir o Modal Popup do Ultimate Addons que não abre no WordPress

O modal popup do Ultimate Addons não abre quando o tipo de gatilho está mal configurado, quando o elemento de clique não recebe a classe ou ID que dispara o modal, ou quando um conflito de JavaScript interrompe o script do widget antes de o popup ser acionado.

## O que é Modal Popup do Ultimate Addons que não abre?

O modal popup do Ultimate Addons (UAE) é um widget do Elementor que exibe uma janela sobreposta acionada por um gatilho. Segundo a documentação oficial, ele pode abrir de duas formas: pelo clique em um botão, texto, imagem, ícone ou qualquer outro widget; ou por gatilhos automáticos, como Exit Intent (quando o visitante tenta sair da página), After Few Seconds (depois de alguns segundos) e com controle de frequência via cookies. O conteúdo do modal fica oculto até que o gatilho configurado seja disparado.

Quando o modal não abre, a integração entre o gatilho e o widget falhou em algum ponto: o botão de disparo não está apontando para o modal correto, o tipo de gatilho escolhido não corresponde ao comportamento esperado, ou um erro de JavaScript no console derruba o script do UAE antes de o clique ser registrado. Como o widget depende de JS no frontend, qualquer interrupção no carregamento da página impede a abertura, mesmo com o modal corretamente montado no editor.

## Como identificar

- Você clica no botão, imagem ou ícone configurado e nada acontece: o modal popup não aparece e a página continua igual.
- O modal funciona dentro do editor do Elementor (na prévia), mas não abre na página publicada vista pelo visitante.
- No console do navegador (F12 -> Console) surgem erros de JavaScript como 'Uncaught TypeError' ou 'is not a function' ao carregar a página com o widget.
- O modal abre sozinho ao carregar a página ou no Exit Intent, mas nunca abre pelo clique no botão que você configurou como gatilho.
- O botão de disparo aparece, mas inspecionando o elemento (botão direito -> Inspecionar) ele não tem a classe ou o ID que o gatilho do modal espera.

**Antes de começar:** Antes de desativar plugins, trocar o tema ou mexer nas configurações de cache em produção, faça um backup completo do site (arquivos e banco de dados) ou teste primeiro em um ambiente de staging, para reverter caso alguma página quebre.

## Como prevenir

- Padronize o uso de uma classe CSS própria como gatilho do modal e documente qual elemento dispara cada popup, evitando seletores soltos que somem em ajustes futuros.
- Mantenha o Elementor e o Ultimate Addons for Elementor sempre na versão estável mais recente, validando antes em staging para acompanhar mudanças nos controles de gatilho do modal.
- Configure exceções no plugin de cache para não minificar nem adiar os scripts do Elementor e do UAE, que o modal popup depende para abrir.
- Verifique o console do navegador depois de publicar páginas com modal, garantindo que nenhum plugin novo introduziu erro de JavaScript que derrube o gatilho.

Erros relacionados

- [Como corrigir pop-ups que não aparecem no Elementor](https://full.services/wp-fixer/corrigir-popup-nao-aparece-elementor/)
- [Como corrigir erros de JavaScript no console ao usar o Elementor](https://full.services/wp-fixer/corrigir-erro-javascript-console-elementor/)
- [Como corrigir CSS do Elementor que não aplica no frontend](https://full.services/wp-fixer/corrigir-elementor-css-nao-aplica/)

## Causa

- O tipo de gatilho do widget está em um modo automático (Exit Intent, After Few Seconds ou On Page Load) quando o esperado era abrir por clique, então nenhum clique no botão dispara o modal.
- O elemento que deveria abrir o modal (botão, imagem ou ícone) não recebeu a classe CSS ou o ID que o gatilho do Ultimate Addons usa como seletor para detectar o clique, conforme o guia oficial de abrir o modal pelo clique de um widget.
- Um erro de JavaScript de outro plugin ou do tema interrompe o carregamento dos scripts do Elementor e do UAE antes da inicialização do modal, deixando o gatilho inerte no frontend.
- Um plugin de otimização (minify, defer ou combinação de JavaScript) atrasou ou quebrou o script do widget Modal Popup, fazendo o handler do clique não registrar na página publicada.
- O cache da página entregou uma versão antiga, anterior à configuração do gatilho, então o visitante recebe HTML sem o modal devidamente vinculado ao botão.
- O Ultimate Addons for Elementor ou o próprio Elementor está desatualizado e o controle de gatilho do modal mudou de comportamento entre versões, deixando a configuração antiga sem efeito.

## Como resolver

1. Confira o tipo de gatilho do widget Modal Popup: Edite a página no Elementor, selecione o widget Modal Popup e abra a aba de conteúdo. Verifique se o gatilho está no modo desejado: para abrir no clique, escolha o disparo por widget ou botão; os modos Exit Intent e After Few Seconds são automáticos e não respondem a clique.

```
Painel WP -> Páginas -> Editar com Elementor
Selecione o widget Modal Popup -> aba Conteúdo -> seção de Trigger/Display Settings
Defina o gatilho de clique e desmarque Exit Intent / After Few Seconds se não forem o objetivo
```

2. Vincule o botão de clique ao modal pela classe ou ID: Se você usa um botão externo para abrir o modal, ele precisa carregar exatamente a classe CSS ou o ID que o Ultimate Addons usa como gatilho. Abra as configurações avançadas do botão e adicione o seletor indicado pelo widget Modal Popup.

```
Selecione o botão de disparo -> aba Avançado -> CSS Classes
Insira a classe de gatilho definida no widget Modal Popup (ex.: a classe do seletor de abertura)
Salve e atualize a página para aplicar o vínculo
```

3. Teste o modal na página publicada, não só no editor: Abra a página real em uma aba anônima e clique no gatilho. O modal pode funcionar na prévia do editor e falhar no frontend por causa de cache ou scripts. Se falhar, prossiga para isolar conflito.

```
Abra a URL pública da página em uma janela anônima do navegador
Clique no botão ou elemento de gatilho e observe se o modal abre
Compare o comportamento com a prévia dentro do editor do Elementor
```

4. Inspecione o console em busca de erros de JavaScript: Abra o console do navegador na página publicada e recarregue. Erros de JavaScript de outro plugin interrompem o script do UAE e impedem o clique de abrir o modal. Anote o arquivo que dispara o erro para identificar o culpado.

```
Abra o console do navegador: tecla F12 -> aba Console
Recarregue a página e observe linhas em vermelho ao carregar
Anote o plugin ou arquivo .js citado no erro
```

5. Desative otimização de JavaScript e limpe o cache: Plugins de cache que minificam, adiam ou combinam JavaScript costumam quebrar o script do Modal Popup. Desligue essas opções para os scripts do Elementor, limpe todo o cache e teste o gatilho novamente.

```
No plugin de cache, desative Minify/Combine/Defer de JavaScript
Limpe o cache do site e do CDN (purge total)
Recarregue a página publicada e teste o clique no gatilho
```

6. Isole conflito de plugin ou tema: Se o modal ainda não abrir, desative os demais plugins um a um (mantendo Elementor e UAE) e troque temporariamente para um tema padrão, recarregando a página a cada teste até identificar o que interrompe o script do widget.

```
Painel WP -> Plugins -> desative os demais plugins um a um
Painel WP -> Aparência -> Temas -> ative um tema padrão (ex.: Twenty Twenty-Four)
Recarregue a página e teste o gatilho do modal a cada mudança
```


## Código

```css
/* Garante que o botao de gatilho do Modal Popup do UAE fique clicavel */
/* Troque .abre-modal pela classe de gatilho definida no widget Modal Popup */
.abre-modal {
    cursor: pointer;
    position: relative;
    z-index: 10;
    pointer-events: auto;
}

/* Evita que um overlay invisivel de outra secao cubra o gatilho e bloqueie o clique */
.elementor-section-overlap {
    pointer-events: none;
}
.elementor-section-overlap .abre-modal {
    pointer-events: auto;
}
```

## Perguntas frequentes

### Por que o modal popup do Ultimate Addons não abre ao clicar no botão

Quase sempre o botão de clique não está vinculado ao modal pela classe ou ID que o widget usa como gatilho, ou o gatilho está em modo automático como Exit Intent. Confirme o tipo de gatilho no widget e adicione a classe de abertura ao botão em Avançado -> CSS Classes.

### O modal funciona no editor do Elementor mas não na página publicada

Isso aponta para cache ou conflito de scripts no frontend. Abra a página em uma janela anônima, limpe todo o cache do site e do CDN e desative a minificação de JavaScript do plugin de cache para os scripts do Elementor e do Ultimate Addons.

### Quais tipos de gatilho o Modal Popup do Ultimate Addons oferece

Segundo a documentação oficial, o modal abre pelo clique em um botão, texto, imagem, ícone ou outro widget, e por gatilhos automáticos como Exit Intent, After Few Seconds e controle de frequência por cookies. Escolha o gatilho conforme o comportamento desejado.

### Como abrir o modal popup pelo clique de outro widget do Elementor

O Ultimate Addons permite acionar o modal por um elemento externo aplicando a classe de gatilho a esse widget. Adicione a classe indicada pelo Modal Popup no campo CSS Classes do widget que deve disparar a abertura, conforme o guia oficial do plugin.

### Um erro de JavaScript pode impedir o modal de abrir

Sim. Como o modal popup depende de JavaScript no frontend, um erro de outro plugin ou do tema interrompe o script do widget antes de o clique ser registrado. Abra o console do navegador, identifique o arquivo que dispara o erro e desative o plugin responsável.

### O plugin de cache pode quebrar o gatilho do modal popup

Pode. Opções de minificar, combinar ou adiar JavaScript costumam quebrar o script do Modal Popup na página publicada. Crie exceções para os scripts do Elementor e do Ultimate Addons no plugin de cache e limpe o cache após salvar.

### O modal abre sozinho mas não abre no clique, o que fazer

O gatilho está configurado em um modo automático como After Few Seconds ou On Page Load. Volte ao widget Modal Popup, ajuste o gatilho para disparo por clique e vincule o botão correto pela classe de abertura do modal.

### Preciso atualizar o Ultimate Addons para o modal voltar a abrir

Vale verificar. Versões antigas do Elementor ou do UAE podem usar controles de gatilho diferentes dos atuais, deixando a configuração sem efeito. Atualize ambos para a versão estável mais recente, de preferência testando antes em staging.

**Fonte:** [Ultimate Addons for Elementor — Modal Popup Widget (documentação oficial)](https://ultimateelementor.com/docs/modal-popup-widget/)