documentazione di REEID Translate Pro
Hub della documentazione di REEID Translate
Scopri come funziona REEID Translate Pro, come iniziare in sicurezza e come usare in ambienti WordPress di produzione le sue funzionalità di traduzione, localizzazione, glossario, SEO, builder, WooCommerce e Cloud Assist.
Inizia in piccolo
Traduci prima una pagina, un prodotto o un articolo. Controlla il risultato, verifica il layout, poi continua con altre lingue o flussi di lavoro in blocco.
Scegli una modalità
Usa Local BYOK quando vuoi che la tua chiave OpenAI rimanga sul tuo sito WordPress, oppure Cloud Assist quando desideri il flusso di lavoro assistito dal cloud di REEID e il riutilizzo della cache.
Proteggi la struttura
REEID traduce il testo preservando la struttura di WordPress, i dati dell’editor, le relazioni SEO, gli slug e i modelli di contenuto specifici dei page builder, dove supportati.
Per iniziare
Come traduco un articolo o una pagina?
Apri il pannello REEID Translate all’interno dell’editor, scegli la lingua di destinazione, quindi avvia la traduzione. Se esiste già una traduzione, REEID aggiorna la versione tradotta esistente invece di creare duplicati inutili.
Quali editor e tipi di contenuto sono supportati?
- Pagine e articoli Gutenberg
- Contenuti dell’Editor classico
- Pagine e nodi di testo di Elementor
- Prodotti WooCommerce e stringhe dei prodotti
- Titoli e slug
- Contenuto del corpo e blocchi dell’editor
- Campi SEO, dove supportato
- Relazioni di traduzione e metadati della lingua
Dove vengono memorizzate le traduzioni?
REEID utilizza, ove possibile, le strutture native di WordPress e le relazioni tra i metadati. Questo evita fragili sistemi ombra e aiuta a mantenere i contenuti tradotti più facili da gestire, ispezionare, correggere e mantenere nel lungo periodo.
Posso ritradurre in sicurezza?
Sì. La nuova esecuzione della traduzione è progettata per aggiornare la traduzione esistente preservando relazioni e struttura. Per ottenere i migliori risultati, mantieni coerente l’editor originale ed evita di mescolare i dati del builder provenienti da editor diversi.
Modalità BYOK locale
BYOK locale significa “Bring Your Own Key”. In questa modalità, la tua chiave API OpenAI rimane sul tuo sito WordPress ed è utilizzata dal motore di traduzione lato plugin.
- Ideale per gli utenti che desiderano un controllo locale della propria chiave API.
- Le richieste di traduzione vengono avviate dal flusso di lavoro dell’admin di WordPress.
- L’utilizzo di OpenAI dipende dal tuo account OpenAI e dalla configurazione del modello.
- È la scelta migliore quando preferisci un controllo locale diretto rispetto all’elaborazione assistita dal cloud.
Modalità Cloud Assist
Cloud Assist instrada il flusso di lavoro di traduzione selezionato attraverso il servizio cloud di REEID. Può supportare il riutilizzo della cache, i controlli di utilizzo, l’elaborazione lato cloud e un riutilizzo delle traduzioni più coerente tra esecuzioni ripetute.
- Utile per traduzioni ripetute e per la manutenzione continua del sito.
- Può ridurre l’uso non necessario e ripetuto di token grazie al riutilizzo della cache.
- Può includere limiti di utilizzo a seconda dello stato della licenza e del piano.
- È la scelta migliore quando desideri funzionalità di flusso di lavoro assistite dal cloud.
Riutilizzo della cache di Cloud Assist
Il riutilizzo della cache di Cloud Assist aiuta a evitare di tradurre più e più volte i contenuti invariati. Quando la stessa stringa appare in un’esecuzione di traduzione ripetuta, Cloud Assist può riutilizzare la traduzione precedente invece di inviare ogni stringa invariata al motore di traduzione AI.
- Utile quando traduci di nuovo la stessa pagina.
- Utile dopo piccole modifiche a contenuti esistenti.
- Può riutilizzare stringhe Gutenberg, Elementor, Classic o WooCommerce invariati, dove supportato.
- Può ridurre l’uso ripetuto dei token.
- Non garantisce zero token.
- Il testo modificato richiede comunque una nuova traduzione.
- Le modifiche alla formattazione possono influire sul riutilizzo.
- Le modifiche al prompt o al glossario possono ridurre le corrispondenze nella cache.
Aspettativa pratica: la prima traduzione usa token normali; le ritraduzioni senza modifiche dovrebbero usarne molti meno; le piccole modifiche dovrebbero tradurre soprattutto le stringhe cambiate; le riscritture ampie continueranno a usare più token.
Glossario
Il glossario aiuta a guidare le decisioni di traduzione per nomi di marchi, nomi di prodotti, terminologia preferita, termini che non devono essere tradotti e regole linguistiche specifiche del cliente.
- Aggiungi i termini preferiti prima di tradurre contenuti importanti.
- Proteggi nomi di marchi, nomi di prodotti, codici e terminologia tecnica.
- Usa le regole del glossario per migliorare la coerenza tra pagine e lingue.
- Mantieni stabili le indicazioni del glossario quando usi il riutilizzo della cache di Cloud Assist.
Prompt e istruzioni personalizzate
Le indicazioni del prompt ti consentono di aggiungere istruzioni di traduzione extra senza sostituire le regole fondamentali del plugin per la sicurezza e la conservazione della struttura.
- Preserva nomi o codici prodotto.
- Usa un tono formale, naturale, tecnico o di marketing.
- Segui la terminologia del marchio.
- Adatta lo stile senza modificare la struttura del layout.
Localizzazione delle stringhe
La localizzazione delle stringhe gestisce testi più piccoli a livello di interfaccia che potrebbero non appartenere a una singola pagina o a un singolo prodotto. Questo aiuta a rendere il frontend completamente multilingue.
Etichette del menu
Rivedi le etichette di navigazione, completa automaticamente le traduzioni mancanti e applica sostituzioni manuali per le brevi voci di menu.
Dizionario UI
Memorizza traduzioni riutilizzabili per frasi dell’interfaccia come pulsanti, etichette, intestazioni e testo UI ricorrente.
Revisione semantica
Rivedi le frasi ricorrenti e migliora la coerenza tra lingue, menu, widget e stringhe dell’interfaccia.
Le traduzioni UI memorizzate possono ridurre l’uso ripetuto delle API perché le stringhe dell’interfaccia già note possono essere riutilizzate invece di essere tradotte di nuovo.
Traduzione WooCommerce
REEID Translate Pro supporta la traduzione dei prodotti WooCommerce preservando la configurazione del prodotto. L’obiettivo è tradurre i contenuti del prodotto specifici della lingua senza danneggiare prezzi, inventario, relazioni o la configurazione di base del prodotto.
- Titoli e slug dei prodotti
- Descrizioni brevi e lunghe
- Attributi del prodotto, dove supportato
- Campi SEO, dove supportato
- Preserva la logica di prezzi e disponibilità di magazzino
- Preserva la configurazione del prodotto
- Supporta il riutilizzo delle stringhe prodotto in Cloud Assist
- Progettato per evitare duplicazioni inutili dei prodotti
SEO e indicizzazione
REEID è progettato per supportare la SEO multilingue mantenendo prevedibili le relazioni tra le lingue. Aiuta le pagine tradotte a usare URL consapevoli della lingua, metadati SEO, relazioni hreflang e logica canonica dove supportata.
- Supporta gli slug tradotti, inclusi quelli nella lingua nativa.
- Può funzionare insieme ai principali plugin SEO come Yoast e Rank Math.
- Aiuta, ove possibile, a evitare duplicazioni dei generatori SEO.
- Supporta le relazioni hreflang e canonical per i contenuti tradotti.
- Preserva la struttura originale dell’URL in inglese/radice, se configurata.
Protezione del layout e blocco della contaminazione
REEID protegge i layout rilevando la struttura dell’editor e del builder prima della traduzione. Se una pagina sembra contenere dati misti dell’editor, la traduzione può essere bloccata per evitare di danneggiare il layout.
Perché la traduzione può essere bloccata
- Contenuto Gutenberg con metadati Elementor obsoleti
- Contenuto Elementor con markup dei blocchi misto
- Dati del builder che non corrispondono all’editor attivo
- Conversione della struttura potenzialmente non sicura
Cosa fare
- Apri la pagina nell’editor usato originariamente per crearla.
- Salva una volta, poi prova di nuovo la traduzione.
- Per le pagine ricostruite intenzionalmente, i dati obsoleti del builder potrebbero richiedere una pulizia.
- Non forzare la traduzione se l’origine del layout non è chiara.
Messaggio tipico: la traduzione è stata bloccata per proteggere questo layout. Nessuna modifica è stata apportata.
Messaggi di errore comuni
- AJAX non riuscito: può indicare timeout, problema di nonce, interruzione del server o errore di rete.
- Nonce non valido: aggiorna la pagina di amministrazione e riprova.
- Parametri mancanti: la lingua richiesta, l’ID del post o il valore della richiesta non sono stati inviati.
- Motore di traduzione non disponibile: il runtime di traduzione non è riuscito a caricarsi o è stato bloccato.
- Nessuna lingua abilitata trovata: configura le lingue di destinazione nelle impostazioni.
- Builder misto bloccato: la pagina contiene dati dell’editor in conflitto.
- Licenza non valida: controlla la chiave di licenza e l’attivazione del dominio.
- Limite raggiunto: attendi il ripristino della finestra di utilizzo oppure modifica piano/impostazioni.
Prestazioni e configurazione consigliata
- Il lavoro di traduzione viene eseguito nei flussi di lavoro dell’area di amministrazione; i visitatori del frontend vedono normalmente il contenuto tradotto salvato.
- Usa PHP 8.1 o una versione più recente, ove possibile.
- 256MB di memoria sono un punto di partenza minimo pratico; 512MB o più sono consigliati per siti più grandi.
- Pagine grandi, layout Elementor pesanti, prodotti WooCommerce e traduzioni in blocco possono richiedere più memoria e tempo di esecuzione.
- Il riutilizzo della cache di Cloud Assist può aiutare a ridurre l’uso ripetuto di token sui contenuti invariati.
- Mantieni stabili le istruzioni del prompt e del glossario quando testi il comportamento della cache.
Perché REEID Translate Pro?
REEID Translate Pro è progettato per la traduzione WordPress AI-first con protezione strutturale, attenzione SEO, gestione specifica per i builder, guida del glossario, riutilizzo della cache Cloud Assist e flussi di lavoro pratici per siti web reali.