Player não aparece no front-end

4 min read

O áudio foi gerado corretamente no admin, mas quando você visualiza o post no seu site, não há nenhum player de áudio. Esta página explica as causas mais comuns.

Lista de verificação rápida

Antes de investigar:

  1. Recarregue a página com Ctrl+Shift+R (recarregamento forçado ignora o cache)
  2. Verifique se o post tem áudio na coluna TTS do admin
  3. Verifique se você não está desconectado (alguns temas ocultam elementos visíveis apenas para admins)

Causa 1: O tipo de post não está habilitado

Sintoma: O áudio existe no admin, mas não há player no front-end. Funciona em alguns tipos de post, mas não em outros.

Correção:

  1. Vá para Texto para Voz → Conteúdo.
  2. Verifique se o tipo do post atual está habilitado (Posts, Páginas, Produtos, etc.).
  3. Salve.
  4. Recarregue o post no front-end.

Causa 2: Conflito com o tema

Sintoma: O player aparece em alguns temas, mas não no seu, ou aparece mas está invisível ou quebrado.

Razões comuns:

  • Seu tema remove o filtro the_content onde o TTSWP injeta o player
  • Seu tema usa um template personalizado que ignora os hooks de conteúdo padrão do WordPress
  • O CSS do seu tema oculta o player (display: none em algum lugar)

Correção:

  1. Mude temporariamente para um tema padrão do WordPress (Twenty Twenty-Four).
  2. Recarregue o post.
  3. Se o player aparecer no tema padrão, o problema está no seu tema.

Soluções alternativas:

  • Use o shortcode [mementor-tts] dentro do post para forçar o posicionamento
  • Use o shortcode [tts_player id="123"] em um template de tema personalizado
  • Adicione CSS personalizado para tornar o player visível caso ele esteja sendo ocultado

Causa 3: O posicionamento está definido para uma visualização que não está sendo exibida

Sintoma: O player aparece em algumas páginas, mas não em outras.

Exemplo: Se o posicionamento for Antes do resumo, o player só aparece em páginas de arquivo e listas de blog, não em posts individuais.

Correção:

  1. Vá para Texto para Voz → Player.
  2. Verifique o menu suspenso Posicionamento.
  3. Mude para Após o título ou Após o conteúdo para o posicionamento mais universal.
  4. Salve.

Causa 4: O cache está servindo uma versão antiga

Sintoma: O player aparece em uma janela anônima, mas não no seu navegador regular.

Correção:

  1. Limpe o cache do seu navegador (Ctrl+Shift+Delete).
  2. Se você usa um plugin de cache (WP Rocket, LiteSpeed, etc.), limpe o cache dele.
  3. Se você usa um CDN (Cloudflare, etc.), limpe o cache dele.

Veja Plugins de cache.

Causa 5: JavaScript bloqueado

Sintoma: O HTML do player está lá (visualizar código-fonte), mas parece quebrado ou estático.

Por que: O player usa JavaScript para os controles. Se o JS estiver bloqueado, o player aparece como HTML sem estilo.

Correção:

  • Verifique o console do navegador em busca de erros de JS
  • Desative bloqueadores de anúncios ou bloqueadores de conteúdo no seu site
  • Verifique se nenhum outro plugin está removendo o mementor-tts-public.js da fila

Causa 6: Problema de roteamento do Weglot ou WPML

Sintoma: O player funciona no idioma original, mas não nas páginas traduzidas (ou vice-versa).

Correção: Certifique-se de que o toggle de integração do Weglot ou WPML está ativado. Vá para Texto para Voz → Visão Geral → Configurações Rápidas. Veja Integração com WPML e Integração com Weglot.

Causa 7: Versão AMP da página

Sintoma: O player aparece na versão regular, mas não na versão AMP.

Por que: O AMP tem regras rígidas sobre JavaScript. O player do TTSWP não funciona dentro de páginas AMP.

Solução alternativa: Direcione os visitantes para a versão não-AMP, ou use uma abordagem diferente para áudio em páginas AMP.

Ainda com problemas?

Se nenhuma das opções acima resolver:

  1. Acesse Texto para Voz → Suporte PRO ou a página de suporte
  2. Inclua: nome do seu tema, versão do WordPress, versão do plugin, navegador, um screenshot do post e da coluna TTS no admin

Páginas relacionadas