# Como corrigir o Lightbox da Image Gallery no Ultimate Addons

O Lightbox da Image Gallery do Ultimate Addons para de abrir quando o Click Action do widget não está configurado como Lightbox, quando outro lightbox concorrente ou a otimização de JavaScript de um plugin de cache bloqueiam o script que monta o popup.

## O que é Lightbox da Image Gallery do Ultimate Addons?

O Image Gallery Lightbox do Ultimate Addons (UAEL) é o popup que amplia a foto sobre um fundo escurecido quando o visitante clica em uma miniatura da galeria. Ele é ligado no painel do widget pela opção Click Action, dentro de Additional Options, escolhendo Lightbox em vez de abrir um link externo. Com o Lightbox ativo, o UAEL ainda oferece as Advanced Lightbox Actions (zoom, compartilhar, slideshow, tela cheia, download e galeria) no canto superior direito do popup.

Quando esse recurso falha, o clique na imagem não faz nada, abre a foto crua em uma nova aba ou exibe a imagem sem o overlay escuro e sem os controles. Na prática, três famílias de causa concentram os casos: configuração do próprio widget (Click Action em outro valor ou link customizado por imagem sobrescrevendo o lightbox), conflito com um segundo lightbox ativo na página (lightbox do Elementor, de um tema ou de outro plugin) e quebra do JavaScript do UAEL por defer, combine ou minify de um plugin de cache. Identificar em qual família o site está é o que destrava a correção.

## Como identificar

- Ao clicar em uma imagem da galeria nada acontece: o popup não abre e a página continua parada.
- O clique abre o arquivo da imagem em uma nova aba ou no mesmo separador, em vez de exibir o lightbox sobre a página.
- No console do navegador aparece 'Uncaught ReferenceError' ou 'is not a function' ligado ao script do lightbox logo ao clicar na miniatura.
- A imagem amplia, mas sem o fundo escurecido e sem os botões de zoom, slideshow, tela cheia ou download no canto superior direito.
- O lightbox funciona no editor do Elementor, mas para de abrir na página publicada para o visitante.

**Antes de começar:** Antes de alterar exclusões de cache, desativar plugins de galeria ou mexer no lightbox do Elementor em produção, faça um backup do site ou teste primeiro em um ambiente de staging, para reverter sem prejuízo caso outra página dependa dessas configurações.

## Como prevenir

- Padronize o Click Action como Lightbox ao criar cada Image Gallery e evite preencher Custom Link nas imagens que devem abrir no popup.
- Use apenas um lightbox por página: escolha entre o do Ultimate Addons e o do Elementor e mantenha desligado o que não for usar na galeria.
- Sempre que ligar otimização de JavaScript em um plugin de cache, teste o lightbox da galeria na página publicada e mantenha o handle do UAEL na lista de exclusões.
- No layout Justified com filtro, deixe o Last Row Layout em Justify desde o início para que todas as miniaturas continuem clicáveis sob as abas.

Erros relacionados

- [Como corrigir o Modal Popup que não abre no Ultimate Addons](https://full.services/wp-fixer/corrigir-modal-popup-ultimate-addons/)
- [Como corrigir o conflito de JavaScript entre Ultimate Addons e WP Rocket](https://full.services/wp-fixer/corrigir-conflito-js-ultimate-addons-wp-rocket/)
- [Como corrigir o Ultimate Addons que não carrega widgets no Elementor](https://full.services/wp-fixer/corrigir-widgets-nao-carregam-ultimate-addons/)

## Causa

- A opção Click Action do widget (Content -> Additional Options -> Click Action) está configurada como None ou como link externo, e não como Lightbox, então o clique não dispara o popup.
- Cada imagem da galeria recebeu um link customizado próprio: o Custom Link por imagem sobrescreve a ação de Lightbox e o clique segue para a URL em vez de abrir o popup.
- Há um segundo lightbox ativo na mesma página (o lightbox nativo do Elementor, do tema ou de outro plugin de galeria), e os dois disputam o evento de clique, fazendo um anular o outro.
- Um plugin de cache (WP Rocket, LiteSpeed Cache ou Autoptimize) está aplicando defer, delay ou combine ao JavaScript, e o script de lightbox do Ultimate Addons não carrega antes do clique do visitante.
- A galeria usa layout Justified com a Filterable Gallery ligada e o Last Row Layout ficou em Hide: parte das imagens não é exibida sob as abas de filtro e essas miniaturas nunca chegam a acionar o lightbox.

## Como resolver

1. Confirme o Click Action como Lightbox no widget: Edite a página no Elementor e abra o widget Image Gallery. Em Content, dentro de Additional Options, ajuste a opção Click Action para Lightbox, que é a configuração que faz o clique abrir o popup sobre a página em vez de seguir um link.

```
Elementor -> selecione o widget Image Gallery
Content -> Additional Options -> Click Action: Lightbox
Atualize a página e teste o clique em uma miniatura
```

2. Remova links customizados que sobrescrevem o lightbox: Se imagens individuais receberam um Custom Link, esse link tem prioridade sobre o Lightbox e o clique vai para a URL. Abra cada imagem na galeria e limpe o campo de link customizado nas que devem abrir no popup.

```
Elementor -> Image Gallery -> Gallery -> abra cada item da galeria
Apague o conteúdo do campo Custom Link das imagens que devem abrir no Lightbox
```

3. Desligue lightboxes concorrentes na página: Com mais de um lightbox ativo, os scripts disputam o clique. Desative o lightbox nativo do Elementor para a página e confira se o tema ou outro plugin de galeria não está injetando um segundo lightbox no mesmo conteúdo.

```
Elementor -> menu (hambúrguer) -> Site Settings -> Lightbox -> desligue o lightbox do Elementor para a página da galeria
Painel WP -> Plugins -> identifique e desative plugins de galeria/lightbox redundantes nessa página
```

4. Exclua o JavaScript do UAEL da otimização de cache: Se o lightbox volta a funcionar com o cache desligado, o defer, delay ou combine de JavaScript está quebrando o script. Adicione o handle do Ultimate Addons às exclusões de JavaScript do plugin de cache em vez de desligar a otimização inteira.

```
WP Rocket -> File Optimization -> Excluded JavaScript Files: adicione /uael/
WP Rocket -> Media: exclua a galeria do LazyLoad se as miniaturas não carregarem
Limpe todo o cache e recarregue a página publicada
```

5. Ajuste o Last Row no layout Justified com filtro: Quando a galeria usa o layout Justified com a Filterable Gallery ligada, defina o Last Row Layout como Justify. Com o valor Hide, parte das imagens some sob as abas de filtro e essas miniaturas nunca abrem o lightbox, segundo a documentação do widget.

```
Elementor -> Image Gallery -> Layout: Justified com Filterable Gallery ativa
Last Row Layout: Justify (não use Hide)
```


## Código

```php
<?php
/**
 * Exclui o JavaScript do Ultimate Addons (UAEL) da otimizacao do WP Rocket
 * para destravar o Lightbox da Image Gallery quando o defer/combine quebra o popup.
 * Coloque no functions.php do tema filho ou em um plugin de snippets.
 */
add_filter( 'rocket_exclude_js', 'full_uael_lightbox_exclude_js' );
function full_uael_lightbox_exclude_js( $excluded ) {
    $excluded[] = '/wp-content/plugins/header-footer-elementor/(.*).js';
    $excluded[] = '/wp-content/plugins/ultimate-elementor/(.*).js';
    return $excluded;
}

// Tambem remove os handles do UAEL do delay de JS (Delay JavaScript Execution).
add_filter( 'rocket_delay_js_exclusions', 'full_uael_lightbox_exclude_delay' );
function full_uael_lightbox_exclude_delay( $excluded ) {
    $excluded[] = 'uael-frontend-script';
    $excluded[] = 'uael-image-gallery';
    return $excluded;
}
```

## Perguntas frequentes

### Por que o lightbox da Image Gallery do Ultimate Addons não abre ao clicar

Na maioria das vezes o Click Action do widget não está em Lightbox. Edite a galeria no Elementor, vá em Content, Additional Options e ajuste Click Action para Lightbox. Se ainda não abrir, verifique links customizados nas imagens e conflitos de cache.

### Como ativo o lightbox no widget Image Gallery

O lightbox é ligado na aba Content do widget, dentro de Additional Options, na opção Click Action: escolha Lightbox para que o clique abra a imagem em popup sobre a página em vez de seguir um link externo, conforme a documentação do Ultimate Addons.

### Por que ao clicar na imagem ela abre em uma nova aba em vez do popup

Isso indica que a imagem tem um Custom Link configurado ou que o Click Action está como link, e não como Lightbox. O link customizado por imagem tem prioridade sobre o popup, então remova esse link nas fotos que devem abrir no lightbox.

### O WP Rocket pode quebrar o lightbox do Ultimate Addons

Sim. As opções de defer, delay e combine de JavaScript podem impedir o script do lightbox de carregar a tempo. Adicione o handle do Ultimate Addons (uael) às exclusões de JavaScript do WP Rocket e limpe o cache para restaurar o popup.

### Posso usar o lightbox do Ultimate Addons e o do Elementor juntos

Não é recomendado na mesma página. Dois lightboxes ativos disputam o evento de clique e um pode anular o outro. Escolha apenas um e desligue o concorrente em Site Settings do Elementor ou no plugin que o adiciona.

### Quais controles aparecem no lightbox da galeria

Com o Lightbox ativo, o Ultimate Addons exibe as Advanced Lightbox Actions no canto superior direito do popup: zoom, compartilhar, slideshow, tela cheia, download e galeria. Se eles não aparecem, o popup provavelmente está sendo aberto por outro lightbox.

### Por que algumas imagens da galeria com filtro não abrem o lightbox

No layout Justified com a Filterable Gallery ativa, se o Last Row Layout estiver em Hide, parte das imagens some sob as abas de filtro e essas miniaturas não acionam o popup. Defina o Last Row Layout como Justify para manter todas clicáveis.

### O lightbox funciona no editor mas não na página publicada, o que houve

Quase sempre é o cache. No editor o Elementor não aplica defer nem combine de JavaScript, mas na página publicada o plugin de cache otimiza os scripts e pode quebrar o lightbox. Limpe o cache e exclua o JavaScript do UAEL da otimização.

**Fonte:** [Ultimate Addons for Elementor — Image Gallery Widget (documentação oficial)](https://ultimateelementor.com/docs/image-gallery/)