Il player non appare nel front-end

4 min read

L'audio generato correttamente nell'admin, ma quando visualizzi il post sul tuo sito non c'e nessun player audio. Questa pagina illustra le cause piu comuni.

Lista di controllo rapida

Prima di procedere:

  1. Ricarica la pagina con Ctrl+Shift+R (il refresh forzato bypassa la cache)
  2. Verifica che il post abbia audio nella colonna TTS dell'admin
  3. Verifica di non essere disconnesso (alcuni temi nascondono gli elementi visibili solo agli amministratori)

Causa 1: Il tipo di post non e abilitato

Sintomo: L'audio esiste nell'admin, ma nessun player nel front-end. Funziona su alcuni tipi di post ma non su altri.

Soluzione:

  1. Vai su Da testo a voce - TTSWP → Contenuto.
  2. Verifica che il tipo di post corrente sia abilitato (Post, Pagine, Prodotti, ecc.).
  3. Salva.
  4. Ricarica il post nel front-end.

Causa 2: Conflitto con il tema

Sintomo: Il player appare con alcuni temi ma non con il tuo, oppure appare ma e invisibile o non funziona.

Motivi comuni:

  • Il tuo tema rimuove il filtro the_content dove TTSWP inserisce il player
  • Il tuo tema usa un template personalizzato che bypassa gli hook predefiniti di WordPress
  • Il CSS del tuo tema nasconde il player (display: none da qualche parte)

Soluzione:

  1. Passa temporaneamente a un tema WordPress predefinito (Twenty Twenty-Four).
  2. Ricarica il post.
  3. Se il player appare con il tema predefinito, il problema e il tuo tema.

Soluzioni alternative:

  • Usa lo shortcode [mementor-tts] all'interno del post per forzare il posizionamento
  • Usa lo shortcode [tts_player id="123"] in un template di tema personalizzato
  • Aggiungi CSS personalizzato per rendere visibile il player se viene nascosto

Causa 3: Il posizionamento e impostato su una visualizzazione che non appare

Sintomo: Il player appare su alcune pagine ma non su altre.

Esempio: Se il posizionamento e impostato su Prima dell'estratto, il player appare solo nelle pagine di archivio e nelle liste del blog, non nei singoli post.

Soluzione:

  1. Vai su Da testo a voce - TTSWP → Player.
  2. Controlla il menu a tendina Posizionamento.
  3. Passa a Dopo il titolo o Dopo il contenuto per il posizionamento piu universale.
  4. Salva.

Causa 4: La cache sta servendo una versione precedente

Sintomo: Il player appare in una nuova finestra in incognito ma non nel tuo browser normale.

Soluzione:

  1. Svuota la cache del browser (Ctrl+Shift+Delete).
  2. Se usi un plugin di caching (WP Rocket, LiteSpeed, ecc.), svuota la sua cache.
  3. Se usi una CDN (Cloudflare, ecc.), elimina la sua cache.

Vedi Plugin di caching.

Causa 5: JavaScript bloccato

Sintomo: L'HTML del player e presente (visualizza sorgente), ma appare non formattato o statico.

Motivo: Il player usa JavaScript per i controlli. Se JS e bloccato, il player appare come HTML non stilizzato.

Soluzione:

  • Controlla la console del browser per errori JS
  • Disabilita gli adblocker o i content blocker sul tuo sito
  • Verifica che nessun altro plugin stia rimuovendo la coda di mementor-tts-public.js

Causa 6: Problema di routing con Weglot o WPML

Sintomo: Il player funziona nella lingua originale ma non nelle pagine tradotte (o viceversa).

Soluzione: Assicurati che l'integrazione con Weglot o WPML sia attiva. Vai su Da testo a voce - TTSWP → Panoramica → Impostazioni rapide. Vedi Integrazione WPML e Integrazione Weglot.

Causa 7: Versione AMP della pagina

Sintomo: Il player appare nella versione normale ma non in quella AMP.

Motivo: AMP ha regole rigide riguardo a JavaScript. Il player TTSWP non funziona all'interno delle pagine AMP.

Soluzione alternativa: Indirizza i visitatori alla versione non AMP, oppure usa un approccio diverso per l'audio nelle pagine AMP.

Ancora bloccato?

Se nessuna delle soluzioni precedenti funziona:

  1. Controlla Da testo a voce - TTSWP → Supporto PRO o la pagina di supporto
  2. Includi: nome del tema, versione di WordPress, versione del plugin, browser, uno screenshot del post e della colonna TTS nell'admin

Pagine correlate