Problemi di installazione o attivazione

4 min read

Hai provato a installare o attivare TTSWP e qualcosa è andato storto. O l'installazione è fallita, il plugin mostra un errore fatale, oppure il menu non appare dopo l'attivazione. Questa pagina tratta le cause più comuni, in ordine dalla più alla meno probabile.

Causa 1: Versione PHP troppo vecchia

Sintomo: WordPress rifiuta di attivare il plugin con un errore come "Il plugin richiede PHP 7.2 o superiore" oppure mostra una schermata bianca subito dopo l'attivazione.

Perché: TTSWP richiede PHP 7.2 o versione più recente. Molti host eseguono ancora PHP 7.0 o 7.1 per impostazione predefinita sugli account meno recenti.

Soluzione:

  1. Apri il pannello di controllo del tuo hosting (cPanel, Plesk, SiteGround, Kinsta, WP Engine, ecc.).
  2. Trova il selettore della versione PHP (spesso in "PHP Selector" o "Site Tools → PHP Manager").
  3. Passa a PHP 8.0 o superiore. PHP 8.2 è la versione attualmente consigliata.
  4. Prova ad attivare di nuovo il plugin.

Se non riesci a cambiare PHP dal pannello di controllo, contatta il tuo host. Quasi tutti gli host supportano PHP 8.x nel 2026.

Causa 2: I permessi sui file bloccano il caricamento

Sintomo: "Installazione plugin non riuscita" o "Impossibile creare la directory" durante il caricamento dello zip o l'installazione dalla directory.

Perché: La directory wp-content/plugins/ non è scrivibile dal server web.

Soluzione:

  1. Connettiti al tuo sito tramite SFTP o il file manager del tuo host.
  2. Imposta i permessi di wp-content/plugins/ a 755 (o 775 su alcuni host).
  3. Imposta i file al suo interno a 644.
  4. Riprova l'installazione.

Su molti host gestiti (Kinsta, WP Engine, Pressable) il file manager lo gestisce automaticamente. Se sei bloccato, chiedi al tuo host di correggere i permessi della directory dei plugin.

Causa 3: Conflitto con un plugin durante l'attivazione

Sintomo: L'attivazione genera un errore fatale che menziona il nome di una funzione, un nome di classe o "Cannot redeclare". Il sito potrebbe andare offline finché il plugin non viene disattivato.

Perché: Un altro plugin attivo definisce una funzione o una classe con lo stesso nome (raro ma possibile), oppure un plugin di sicurezza sta bloccando l'attivazione.

Soluzione:

  1. Rinomina wp-content/plugins/text-to-speech-tts/ in text-to-speech-tts.off tramite SFTP. Il sito torna online.
  2. Disattiva tutti gli altri plugin da Plugin → Plugin installati.
  3. Rinomina la cartella di TTSWP con il nome originale.
  4. Attiva prima TTSWP, poi riattiva gli altri plugin uno alla volta. Il plugin che causa problemi quando TTSWP è attivo è quello in conflitto.
  5. Contatta il supporto con il nome del plugin in conflitto. Ti aiuteremo a trovare una soluzione.

Causa 4: Il menu Testo in Voce manca dopo l'attivazione

Sintomo: Il plugin risulta Attivo in Plugin → Plugin installati, ma non c'è nessuna voce Testo in Voce nella barra laterale di amministrazione.

Perché: Il tuo ruolo utente non ha la capacità manage_options, oppure un plugin di sicurezza ha rimosso il menu.

Soluzione:

  • Accedi come Amministratore. I ruoli Editor e inferiori non vedono il menu TTSWP per impostazione predefinita.
  • Se sei già un Amministratore, vai in Utenti → Profilo e conferma che il tuo ruolo sia Amministratore.
  • Disabilita i plugin di sicurezza come iThemes Security, la funzione di nascondere il menu di amministrazione di Wordfence, o Hide My WP uno alla volta e ricarica l'amministrazione. Se il menu riappare, configura quel plugin per consentire text-to-speech-tts-settings.

Causa 5: La colonna TTS manca dalla lista dei post

Sintomo: Il plugin funziona, ma la colonna TTS non appare in Articoli → Tutti gli articoli.

Soluzione:

  1. Apri Articoli → Tutti gli articoli.
  2. Clicca su Opzioni schermata in alto a destra nella schermata.
  3. Spunta la casella TTS.
  4. La colonna appare.

Se la casella non è presente, il tuo tema o un altro plugin la sta filtrando. Passa a un tema predefinito (Twenty Twenty-Five) per verificare.

Causa 6: Versione di WordPress troppo vecchia

Sintomo: L'installazione del plugin fallisce con "Il tuo sito non soddisfa i requisiti minimi".

Perché: TTSWP richiede WordPress 6.0 o versione più recente.

Soluzione: Aggiorna WordPress da Bacheca → Aggiornamenti. Se non riesci ad aggiornare, il tuo host potrebbe mantenerti su una versione precedente - chiedi loro di aggiornare.

Causa 7: HTTPS in uscita bloccato

Sintomo: Il plugin si installa e si attiva correttamente, ma la pagina Panoramica mostra "Impossibile raggiungere i server TTSWP" oppure il pulsante Connetti non fa nulla.

Perché: Il tuo host blocca le richieste HTTPS in uscita da PHP verso domini esterni. Questo è raro su host reali, ma comune negli ambienti di sviluppo locale.

Soluzione:

  • Su localhost, controlla il firewall o la VPN.
  • Su un host reale, aggiungi app.ttswp.com e *.ttswp.com alla lista consentita per HTTPS in uscita.
  • Consulta Risoluzione problemi di connessione per controlli di rete approfonditi.

Ancora bloccato?

Se nessuna di queste soluzioni funziona, raccogli queste informazioni e contatta il supporto:

  • Versione di WordPress (da Bacheca → A colpo d'occhio)
  • Versione PHP (da Strumenti → Salute del sito → Informazioni → Server)
  • Nome e versione del tema attivo
  • Un elenco degli altri plugin attivi
  • Il messaggio di errore esatto che vedi, con uno screenshot se possibile

Pagine correlate