Documentazione Universally

Guide passo-passo, suggerimenti SEO multilingue e best practice per aiutarti a tradurre e scalare il tuo sito WordPress.

Modalità di pubblicazione JavaScript

In modalità JavaScript, un tag di script nell'<head> del tuo sito fa tutto il lavoro: visualizza il selettore di lingua, sceglie una lingua per ogni visitatore e sostituisce il testo della tua pagina con la sua traduzione nel browser. I tuoi URL non cambiano mai, quindi example.com/about è lo stesso indirizzo in ogni lingua e non c'è DNS da configurare. Il compromesso è che i motori di ricerca vedono solo la tua lingua di origine.

La modalità JavaScript è l'unica modalità per Webflow, Framer, Squarespace, Duda, Tilda, Weebly e Lovable, e una delle due opzioni per i progetti di Qualsiasi Sito Web.

Cosa viene tradotto

Universally estrae le stringhe dalla tua pagina con gli stessi parser che utilizza per la traduzione lato server:

  • Testo nella pagina.
  • Il contenuto <title> e meta.
  • Gli attributi placeholder, aria-label, alt, title e value.

Le traduzioni memorizzate, il conteggio delle parole e le regole del glossario funzionano come in ogni altra modalità. Lo script imposta anche <html lang> e dir per la lingua scelta.

Cosa non viene tradotto

  • I motori di ricerca non vedono traduzioni. Le traduzioni esistono solo nel browser e i crawler ottengono il tuo HTML di origine. Non vengono aggiunti link hreflang.
  • Vengono tradotte solo le pagine pubbliche. Universally recupera ogni pagina da solo, senza la sessione del visitatore, quindi una pagina dietro un login o una password mostra il suo testo di origine.
  • Il testo che JavaScript aggiunge dopo il caricamento della pagina non viene tradotto quando non è nell'HTML che il tuo server invia. Lo script riapplica le traduzioni ai nuovi contenuti per alcuni secondi dopo il caricamento e durante le navigazioni di app a pagina singola, ma solo per le stringhe che ha già.
  • JSON-LD non viene tradotto.
  • Le stringhe di query vengono ignorate. ?a=1 e ?a=2 condividono un set di traduzioni.
  • Circa 2.000 stringhe per pagina è il limite. Le stringhe oltre questo numero rimangono nella lingua di origine.
  • Si applicano solo le regole dei selettori CSS. Su Regole di traduzione, Escludi selettori CSS funziona. Escludi pagine ed Escludi localizzazione link non hanno effetto in modalità JavaScript, e nemmeno Includi selettori CSS. Vedi Includi ed escludi selettori CSS.
  • Il selettore non ha impostazioni di design. Si trova nell'angolo in basso a destra con bandiere e nomi di lingua (in alto a destra su Framer e Lovable).

Quando le parole prepagate del progetto sono esaurite, le nuove stringhe rimangono nella lingua di origine e le stringhe già tradotte continuano a essere visualizzate. Vedi Limiti di utilizzo.

Come funziona

  1. Lo script viene caricato. Il file s.js viene servito con una cache di 15 minuti. Finché il progetto è inattivo o non ha una lingua di destinazione attiva, non serve nulla, motivo per cui il tuo sito non cambia finché non aggiungi una lingua.
  2. Una lingua è scelta. Un visitatore alla prima visita viene associato automaticamente alla lingua del browser. La scelta viene memorizzata in un cookie chiamato universally_lang per 30 giorni. La scelta di una lingua nell'switcher imposta il cookie e ricarica la pagina. L'interruttore Reindirizza per lingua del browser nelle Impostazioni generali non ha effetto in questa modalità: l'associazione automatica avviene indipendentemente.
  3. Il browser invia l'URL della pagina. Solo l'URL e la lingua vanno a Universally, mai il contenuto della pagina.
  4. Universally recupera la pagina stessa. Richiede l'URL dal tuo sito pubblicato in modo anonimo, senza cookie del visitatore e senza login, estrae le stringhe, le traduce e le restituisce.
  5. Il browser sostituisce ogni stringa al suo posto. Nulla viene ricaricato e l'indirizzo rimane lo stesso.

Le traduzioni per una pagina vengono memorizzate nella cache per 24 ore sul lato di Universally e conservate nello spazio di archiviazione del browser del visitatore, in modo che una visualizzazione ripetuta non abbia sfarfallii. Le modifiche nella schermata Traduzioni vengono visualizzate una volta scaduta la cache di 24 ore, o subito dopo aver fatto clic su Cancella cache traduttore nelle Impostazioni generali, che cancella entrambe. Vedi Modifica traduzioni manualmente.

Per vedere quanta parte di una pagina è stata tradotta, aggiungi ?uni_debug=1 al suo URL e apri la console del browser.

Quando scegliere i sottodomini

Se desideri che ogni lingua abbia il proprio indirizzo, un progetto Qualsiasi sito web può passare ai sottodomini linguistici dalla sua pagina Configurazione. Il ritorno indietro non è ancora disponibile. Vedi Sottodomini linguistici.

È stato utile?