Tutorial
TutorialRiattivare le traduzioni fallite

Riattivare le traduzioni fallite

Ogni volta che una traduzione fallisce (perché l'API è offline, la chiave API non è valida, i crediti sono esauriti, ecc.), puoi riattivare la traduzione solo per quella voce e quella lingua, evitando di spendere crediti API per le traduzioni che hanno avuto successo.

Noterai che una voce/lingua ha fallito la traduzione perché queste vengono evidenziate con uno sfondo giallo sull'icona di modifica di Polylang nelle pagine di elenco:

Sfondo giallo sull'icona di modifica di Polylang per le traduzioni fallite
Sfondo giallo sull'icona di modifica di Polylang per le traduzioni fallite

Puoi anche filtrare per mostrare solo le voci con traduzioni fallite (solo nelle pagine di elenco Posts e Media):

Filtro per mostrare solo le voci con traduzioni fallite
Filtro per mostrare solo le voci con traduzioni fallite

Filtrare queste voci ti permette di rieseguire facilmente la traduzione per tutte insieme.

Filtro per mostrare solo le voci con traduzioni fallite
Filtro per mostrare solo le voci con traduzioni fallite

Infine, riesegui le traduzioni fallite eseguendo l'azione di gruppo Gato Translate (Custom) e selezionando l'opzione Process failed translations only:

Selezione dell'opzione 'Process failed translations only' nella pagina Settings di 'Gato Translate (Custom)'
Selezione dell'opzione 'Process failed translations only' nella pagina Settings di 'Gato Translate (Custom)'

Se usi i Comandi WP-CLI, puoi riattivare le traduzioni fallite usando il parametro --process-failed.

Suggerimenti

Identificare le traduzioni fallite

Se desideri capire perché una traduzione è fallita, puoi farlo.

Quando una traduzione fallisce, viene mostrato un badge di notifica 🔴 Error nel menu del plugin.

Badge di notifiche
Badge di notifiche

Andando alla voce di menu Logs, sotto la voce query-execution, vedrai il messaggio di errore. È possibile che la traduzione sia fallita per una o più lingue.

In questo screenshot, la traduzione è fallita per il tedesco, perché ChatGPT ha restituito un numero di traduzioni inferiore a quello previsto:

La traduzione è fallita per la lingua tedesca
La traduzione è fallita per la lingua tedesca

In questo caso, tutte le traduzioni sono fallite perché l'endpoint dell'API è andato offline:

Tutte le traduzioni sono fallite
Tutte le traduzioni sono fallite

Qui, la traduzione è fallita per l'italiano e lo spagnolo, a causa di una combinazione di problemi:

La traduzione è fallita per le lingue italiana e spagnola
La traduzione è fallita per le lingue italiana e spagnola

Dal messaggio del log, possiamo identificare la o le lingue che hanno fallito, in modo da rieseguire la traduzione solo per esse ed evitare di spendere inutilmente crediti API.

Non ritradurre lo slug del post

Se la traduzione fallita riguardava un aggiornamento del post solo sul suo contenuto, e avevi già eseguito l'azione Replace internal links, potresti voler evitare di ritradurre lo slug del post, in modo che i link che puntano al post non si rompano.

Per farlo, nelle Settings personalizzate, deseleziona l'opzione Translate custom post slugs?:

Deselezione dell'opzione 'Translate custom post slugs?'
Deselezione dell'opzione 'Translate custom post slugs?'

Passare a un modello migliore

Se la traduzione è fallita perché il modello non è affidabile, puoi passare a un modello migliore.

Ad esempio, il seguente messaggio di errore:

The API for provider 'ChatGPT' returned an array with a lower number of translations than the number of strings to translate  

...si verifica molto probabilmente quando si usa ChatGPT-5 mini, ma non con ChatGPT-5 o modelli superiori.

Puoi quindi passare a uno di questi modelli migliori quando riattivi la traduzione.

Passaggio al modello 'ChatGPT-5.1 (Thinking)'
Passaggio al modello 'ChatGPT-5.1 (Thinking)'