Scopo: Soluzione di problemi ed errori comuni
🚨 Problemi comuni e soluzioni
- Controlla la connessione internet - l'estensione richiede accesso all'API Google Translate
- Assicurati che il testo sia selezionato - seleziona il testo nell'email prima di aprire il menu contestuale
- Controlla la console del browser - apri gli Strumenti di sviluppo (Ctrl+Shift+J) per visualizzare gli errori
- Ricarica l'estensione - torna in about:debugging e ricarica l'estensione
- Ricarica l'estensione - in about:debugging clicca "Reload"
- Controlla le impostazioni della lingua - assicurati che nel popup sia selezionata la lingua di traduzione corretta
- Reinstalla l'estensione - rimuovi e reinstalla l'estensione
- Controlla i permessi - assicurati che l'estensione abbia il permesso "menus"
- Clicca il pulsante "Close" manualmente - usa il pulsante di chiusura nella finestra di traduzione
- Usa il tasto Escape - premi Esc per chiudere immediatamente
- Controlla le impostazioni del tempo - nel popup assicurati che sia impostato il tempo di visualizzazione corretto
- Riavvia Thunderbird - a volte il riavvio dell'applicazione aiuta
- Controlla l'accesso a Google Translate - assicurati che il sito translate.googleapis.com sia accessibile
- Controlla la lunghezza del testo - testi molto lunghi potrebbero superare i limiti dell'API
- Riprova più tardi - potrebbero esserci problemi temporanei con il servizio Google
- Controlla il firewall - assicurati che non ci sia blocco delle richieste all'API Google
🔧 Attivazione del debug e registrazione
In Thunderbird apri about:debugging o premi Ctrl+Shift+J
Nell'elenco delle estensioni trova BuxarTranslate e clicca "Inspect"
Nella finestra degli strumenti di sviluppo apri vai alla scheda "Console"
Esegui una traduzione e rivedi i messaggi nella console per diagnosticare i problemi
Messaggi chiave nei log:
🔍 Diagnostica degli errori comuni
Errore 429 - Too Many Requests
Causa: Superato il limite di richieste all'API Google Translate
Soluzione: Aspetta alcuni minuti e riprova
Errore 403 - Forbidden
Causa: Problemi di accesso all'API o blocco
Soluzione: Controlla la connessione internet e il firewall
Errore caricamento traduzioni
Causa: File di traduzione mancante per la lingua selezionata
Soluzione: Verifica la presenza del file messages.json in _locales
Estensione non si carica
Causa: Errore in manifest.json o incompatibilità delle versioni
Soluzione: Controlla la versione di Thunderbird (dovrebbe essere 78.0+)
🔄 Processo di reinstallazione
Vai in Componenti aggiuntivi → Gestisci estensioni → Rimuovi BuxarTranslate
Riavvia Thunderbird per pulire i dati memorizzati nella cache
Installa nuovamente l'estensione tramite il file .xpi o l'installazione temporanea
Verifica il funzionamento dell'estensione su un'email di test
📞 Supporto e segnalazione errori
- Controlla questa documentazione per una soluzione al tuo problema
- Attiva la registrazione e fornisci i messaggi di errore
- Descrivi i passaggi per riprodurre il problema
- Indica la versione di Thunderbird e del sistema operativo