Image Gallery Lightbox do Ultimate Addons: como corrigir

Tipo Page Builders

Nome do erro Lightbox da Image Gallery do Ultimate Addons não abre EN: Ultimate Addons Image Gallery lightbox not opening

Severidade Informativo

Descrição 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.

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

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
```
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
```
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
```
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
```
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)
```

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.

Atenção

Como corrigir o conflito de lazy load entre Happy Addons e WP Rocket no WordPress

O conflito de lazy load entre Happy Addons e WP Rocket acontece quando o WP Rocket reescreve o atributo src das imagens dos widgets para data-lazy-src e os scripts do Happy Addons disparam antes do carregamento, deixando sliders, image grids e imagens de fundo em branco.

Atenção

Como corrigir o erro de cores no Global Color Palette do Astra Pro no WordPress

O Global Color Palette do Astra Pro não aplica quando o CSS dinâmico do tema fica preso em cache, quando a cor foi fixada manualmente no page builder ou em CSS adicional, ou quando um tema filho sobrescreve as variaveis de cor da paleta. Limpar o cache do Astra e remover os valores fixos restaura as cores em todo o site.

Atenção

Como corrigir o erro de loop em Repeater aninhado no ACF PRO

O erro de loop em Repeater aninhado no ACF PRO acontece quando um have_rows de um Repeater filho e percorrido sem chamar the_row, ou quando o nome do sub campo não casa, gerando loop infinito com tela branca ou nenhuma linha exibida.

Atenção

Como corrigir o Cross Domain Copy Paste que não funciona no Happy Addons

O Happy Addons copy paste não funciona entre sites quando o navegador bloqueia o acesso à área de transferência, a licença Pro não está ativa nos dois domínios ou as versões do Happy Addons Pro estão diferentes, impedindo o X Paste de colar o elemento do Elementor.

Grave

Como corrigir o JetBooking que não processa reservas

Quando o JetBooking não processa a reserva, o formulário de booking é enviado mas nenhuma reserva é gravada na tabela e as datas não ficam bloqueadas. A causa quase sempre é a instância de booking mal configurada, a tabela do plugin não instalada, ou o pedido WooCommerce que nunca chega a um status pago.

Atenção

Como corrigir estilos que não aplicam entre Ultimate Addons e Astra Pro no WordPress

O problema dos estilos do Ultimate Addons e Astra Pro que não aplicam acontece quando o CSS dos widgets UAEL fica preso em arquivos gerados desatualizados, em cache do site ou é sobrescrito pelo CSS dinâmico do Astra Pro, deixando o widget sem visual no frontend.

Setores

Extensões

Integrações

Como corrigir o Lightbox da Image Gallery no Ultimate Addons

O que é Lightbox da Image Gallery do Ultimate Addons?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o conflito de lazy load entre Happy Addons e WP Rocket no WordPress

Como corrigir o erro de cores no Global Color Palette do Astra Pro no WordPress

Como corrigir o erro de loop em Repeater aninhado no ACF PRO

Como corrigir o Cross Domain Copy Paste que não funciona no Happy Addons

Como corrigir o JetBooking que não processa reservas

Como corrigir estilos que não aplicam entre Ultimate Addons e Astra Pro no WordPress

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos