# Como corrigir o widget Sticky Vídeo que não fixa no Essential Addons

O Essential Addons Sticky Vídeo não fixa quando o elemento Sticky Vídeo está desligado no painel do EA, quando o CSS de scroll do plugin não é carregado ou quando outro tema, plugin de cache ou container do Elementor impede o vídeo de flutuar ao rolar a página.

## O que é Sticky Vídeo do Essential Addons que não fixa?

O Essential Addons Sticky Vídeo é um widget do Essential Addons for Elementor que exibe um vídeo do YouTube, Vimeo ou self-hosted e o transforma em um player flutuante quando o visitante rola a página para fora da seção original. O efeito depende de um JavaScript do plugin que detecta a saída do vídeo da viewport e o reposiciona em um canto fixo da tela, usando o estilo Sticky Position escolhido no editor.

Quando esse comportamento falha, o vídeo até aparece no lugar normal, mas não vira o player flutuante ao rolar: ele simplesmente some junto com a seção. As causas mais comuns são o elemento Sticky Vídeo não estar ativado na lista de elementos do EA, o JavaScript ou o CSS do widget não carregarem (cache agressivo, minificação ou deferimento de scripts), ou um conflito de CSS/JS com o tema ou outro plugin que sobrescreve o posicionamento fixo do player.

## Como identificar

- O vídeo aparece normalmente na seção, mas ao rolar a página ele não vira um player flutuante: some junto com o restante do conteúdo.
- O widget exibe a mensagem do Elementor 'Sorry, the content área was not found in your page' ou um espaço vazio no lugar do player no editor.
- No console do navegador surge um erro de JavaScript do tipo 'Uncaught TypeError' ou 'is not a function' logo após o carregamento da página com o Sticky Vídeo.
- O efeito sticky funciona no editor do Elementor, mas para de funcionar no frontend depois de ativar cache ou minificação de scripts.
- O elemento Sticky Vídeo não aparece no painel de widgets do Elementor ao procurar pelo nome, mesmo com o Essential Addons ativo.

**Antes de começar:** Antes de trocar de tema, desativar plugins ou mexer no CSS dos containers 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 a página quebre.

## Como prevenir

- Mantenha o Essential Addons Pro e o Elementor sempre na versão estável mais recente e valide as atualizações em staging antes de subir para produção.
- Sempre exclua os scripts do Essential Addons (eael) das opções de delay, defer e combinação do plugin de cache para não atrasar o JavaScript de scroll do Sticky Vídeo.
- Evite aplicar overflow hidden ou transform no container que envolve o widget Sticky Vídeo, pois isso quebra o position fixed do player flutuante.
- Deixe ativados em Essential Addons -> Elements apenas os widgets realmente usados e confirme que o Sticky Vídeo permanece ligado nas páginas que dependem dele.

Erros relacionados

- [Como corrigir Elementor com widgets que não aparecem](https://full.services/wp-fixer/corrigir-elementor-widgets-nao-aparecem/)
- [Como corrigir pop-ups que não aparecem no Elementor](https://full.services/wp-fixer/corrigir-popup-nao-aparece-elementor/)
- [Como corrigir o Sticky Header que não funciona no Safari no Astra Pro](https://full.services/wp-fixer/corrigir-sticky-header-safari-astra-pro/)

## Causa

- O elemento Sticky Vídeo está desativado em Essential Addons -> Elements: o EA permite ligar e desligar widgets individualmente, e com o Sticky Vídeo desmarcado o widget não é registrado nem renderiza o efeito flutuante.
- Um plugin de cache ou otimização (WP Rocket, Autoptimize, LiteSpeed) está adiando, combinando ou minificando o JavaScript do Essential Addons, impedindo o script de scroll que dispara o efeito sticky de rodar a tempo.
- O Asset Generation / Load Scripts on Demand do EA está em modo que não enfileira o CSS do Sticky Vídeo na página atual, deixando o player sem as regras de position fixed que sustentam a flutuação.
- O vídeo está dentro de um container do Elementor com overflow hidden ou transform aplicado, o que cria um novo contexto de empilhamento e quebra o position fixed do player flutuante.
- Um conflito de jQuery com outro plugin ou com o tema interrompe a fila de scripts antes do Essential Addons inicializar o handler de scroll do Sticky Vídeo.
- O recurso de Sticky Vídeo é exclusivo do Essential Addons Pro e o site tem apenas a versão gratuita ativa, então o widget não fica disponível no editor.

## Como resolver

1. Ative o elemento Sticky Vídeo no Essential Addons: No painel do Essential Addons, abra a aba de elementos e confirme que o Sticky Vídeo está marcado como ativo. Se estiver desligado, o widget não é registrado no Elementor e o efeito flutuante nunca dispara.

```
Painel WP -> Essential Addons -> Elements
Localize 'Sticky Vídeo' na lista e ligue o interruptor
Salve as alterações e recarregue o editor do Elementor
```

2. Confirme que o Essential Addons Pro está ativo: O Sticky Vídeo é um elemento exclusivo do Essential Addons Pro. Verifique se a versão Pro está instalada, ativa e com a licença validada, pois só a versão gratuita não disponibiliza o widget.

```
Painel WP -> Plugins -> verifique 'Essential Addons for Elementor (Pro)' ativo
Painel WP -> Essential Addons -> License -> confirme a licenca ativada
```

3. Limpe o cache e exclua os scripts do EA da otimização: Purgue o cache do site e da CDN e adicione os scripts do Essential Addons à lista de exclusão de combinação, deferimento e minificação do seu plugin de cache, para o JavaScript de scroll do Sticky Vídeo rodar sem atraso.

```
Limpe o cache do plugin (WP Rocket / LiteSpeed / Autoptimize) e da CDN
Exclua 'eael' e 'essential-addons' das opções de delay/defer e combine JS
Recarregue a página no frontend com o cache do navegador desativado (Ctrl+Shift+R)
```

4. Regenere o CSS do Elementor e o asset do EA: Recrie os arquivos de CSS para garantir que as regras de position fixed do Sticky Vídeo sejam reescritas na página. Faça isso pelo Elementor e, se o EA estiver em modo de geração de asset, regenere os arquivos dele também.

```
Painel WP -> Elementor -> Ferramentas -> Regenerar arquivos e dados
Painel WP -> Essential Addons -> Tools -> Regenerate Assets (se disponível)
```

5. Remova overflow e transform do container pai: Abra a seção ou container que envolve o vídeo e remova qualquer overflow hidden ou transform aplicado, pois eles criam um contexto de empilhamento que anula o position fixed do player flutuante.

```
Edite a seção/container -> aba Avancado -> verifique CSS personalizado
Remova 'overflow: hidden' e 'transform' do container que envolve o Sticky Vídeo
Confirme que nenhum CSS do tema aplica overflow hidden ao wrapper do widget
```

6. Isole o conflito de plugin ou tema: Se o efeito ainda falhar, desative os outros plugins um a um e troque para um tema padrão, recarregando o frontend a cada teste para identificar o que interrompe a fila de scripts do EA antes do Sticky Vídeo iniciar.

```
Painel WP -> Plugins -> desative os demais plugins um a um
Painel WP -> Aparencia -> Temas -> ative um tema padrão (ex.: Hello Elementor)
Abra o console (F12 -> Console) e recarregue a página a cada teste
```


## Código

```php
<?php
/**
 * Garante que os assets do Essential Addons sejam enfileirados
 * na pagina do Sticky Video, evitando que cache/otimizacao removam
 * o CSS/JS que sustenta o efeito flutuante.
 */
add_action( 'wp_enqueue_scripts', 'full_force_eael_sticky_video_assets', 99 );
function full_force_eael_sticky_video_assets() {
    // So roda no frontend, fora do editor do Elementor.
    if ( is_admin() ) {
        return;
    }
    if ( wp_style_is( 'eael-general', 'registered' ) && ! wp_style_is( 'eael-general', 'enqueued' ) ) {
        wp_enqueue_style( 'eael-general' );
    }
    if ( wp_script_is( 'eael-general', 'registered' ) && ! wp_script_is( 'eael-general', 'enqueued' ) ) {
        wp_enqueue_script( 'eael-general' );
    }
}
```

## Perguntas frequentes

### Por que o Sticky Vídeo do Essential Addons não fixa ao rolar a página

Na maioria dos casos o JavaScript do Essential Addons não carrega ou foi adiado por um plugin de cache, então o handler de scroll que dispara o efeito flutuante não roda. Exclua os scripts do EA do delay e da combinação de JS e limpe o cache.

### O Sticky Vídeo é um recurso gratuito do Essential Addons

Não. O Sticky Vídeo é um elemento exclusivo do Essential Addons Pro. Na versão gratuita o widget não fica disponível no editor do Elementor, por isso é preciso ter o Pro ativo e a licença validada.

### Por que o efeito sticky funciona no editor mas não no frontend

Isso é típico de cache ou minificação. O editor carrega os scripts sem otimização, mas no frontend o plugin de cache adia ou combina o JavaScript do EA. Exclua os scripts eael das otimizações e purgue o cache do site e da CDN.

### O Sticky Vídeo não aparece na lista de widgets do Elementor, o que fazer

Verifique em Essential Addons -> Elements se o Sticky Vídeo está marcado como ativo e se o Essential Addons Pro está instalado e ativado. Widget desativado ou ausência do Pro removem o elemento do painel de busca do Elementor.

### Quais fontes de vídeo o Sticky Vídeo do Essential Addons aceita

Segundo a documentação oficial, o Sticky Vídeo aceita vídeos do YouTube, do Vimeo e self-hosted. Você define a fonte no tipo de origem do widget e o efeito flutuante funciona igual nas três opções quando os scripts do EA carregam corretamente.

### O overflow hidden do container quebra o Sticky Vídeo

Sim. Um overflow hidden ou um transform aplicado ao container que envolve o vídeo cria um novo contexto de empilhamento e anula o position fixed do player. Remova essas regras do wrapper para o vídeo voltar a flutuar.

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

Desative os demais plugins um a um e troque para um tema padrão, recarregando o frontend a cada teste. Se o efeito sticky voltar, reative os itens até identificar o plugin ou tema que interrompe a fila de scripts do EA.

**Fonte:** [Essential Addons for Elementor — Sticky Video (documentação oficial)](https://essential-addons.com/elementor/sticky-video/)