WPML

Cosa può fare il selettore di lingua di WPML

Già pronto all’uso, WPML genera un selettore che:

  • Mostra tutte le lingue attive sul tuo sito, nell’ordine che preferisci.
  • Etichetta ogni lingua con il suo nome nativo (Deutsch, Français) o nella lingua attuale del sito (German, French), a tua scelta.
  • Mostra facoltativamente le bandiere (uno sprite che si adatta al tuo tema).
  • Gestisce in modo elegante le traduzioni mancanti: salta la lingua oppure inserisce un link alla home page di quella lingua.
  • Può essere posizionato in qualsiasi menu di WordPress, in qualsiasi area widget, nel footer o in linea sopra e sotto gli articoli.
  • È disponibile in un blocco Gutenberg per qualsiasi layout di page builder.
  • Può essere nascosto in pagine specifiche in cui risulterebbe d’intralcio (404, checkout, account).
  • Memorizza nella cache il suo HTML renderizzato per un caricamento rapido della pagina.

La maggior parte dei siti utilizza i posizionamenti integrati e le impostazioni predefinite. Gli sviluppatori di temi che necessitano di un maggiore controllo possono creare un selettore personalizzato nel codice utilizzando l’API di WPML.

Dove si trovano le impostazioni

Apri WPMLImpostazioniSelettori di lingua. La pagina è raggruppata per domanda, non per scheda dell’interfaccia utente. Scegli la sezione che corrisponde a ciò che vuoi modificare.

Quali lingue appaiono e in quale ordine

La scheda Opzioni del selettore di lingua ha un’area drag-and-drop che elenca tutte le lingue attive. L’ordine in questa sezione determina l’ordine in ogni selettore sul sito. Trascina le lingue verso l’alto o verso il basso e salva.

Nella stessa scheda, scegli:

  • Etichetta nativa rispetto alla lingua attuale. Mostra Deutsch (nativa) o German (lingua attuale). L’etichetta nativa è più invitante per chi parla quella lingua; la lingua attuale è più chiara per chi visita il sito per la prima volta.
  • Bandiere attivate o disattivate e il formato della bandiera.

Cosa succede quando manca una traduzione

Non tutte le pagine sono tradotte in tutte le lingue. L’opzione Come gestire le lingue senza traduzione decide cosa fa il selettore per una lingua che non ha una traduzione della pagina corrente:

  • Salta lingua (predefinito). La lingua scompare dal selettore per questa pagina. È l’esperienza utente più pulita: i visitatori vedono solo le lingue che possono effettivamente leggere.
  • Collega alla home page della lingua per le traduzioni mancanti. La voce del selettore mostra invece la home page della lingua. È utile quando vuoi che ogni lingua sia sempre raggiungibile da ogni pagina, ma i visitatori potrebbero finire su contenuti che non si aspettavano.

La scelta ha implicazioni sull’esperienza utente su cui vale la pena riflettere attentamente.

Dove appare il selettore

Cinque posizionamenti, ciascuno attivabile in modo indipendente sulla stessa pagina Impostazioni:

  • Selettore di lingua nel menu. Inserisci il selettore in qualsiasi menu di WordPress (header, footer, barra laterale, ovunque il tuo tema assegni i menu). Aggiungine più di uno se desideri posizionamenti diversi per ogni menu. Ogni selettore del menu ha la sua riga di anteprima che mostra dove si trova.
  • Selettore di lingua nel widget. Aggiungi il selettore a qualsiasi area widget registrata dal tuo tema: barre laterali, zone dell’header, colonne del footer.
  • Selettore di lingua nel footer. Un singolo interruttore globale che renderizza automaticamente il selettore in fondo a ogni pagina.
  • Link in linea alle traduzioni degli articoli. Una singola casella di controllo che mostra i link “questo articolo è disponibile in X” sopra o sotto ogni articolo.
  • Selettori personalizzati. Quando i posizionamenti integrati non sono sufficienti, gli sviluppatori di temi possono richiamare l’API del selettore di WPML da qualsiasi file di template. La pagina Impostazioni espone un pulsante Personalizza per le opzioni di rendering.

Nascondi il selettore in pagine specifiche

Alcune pagine non hanno bisogno di un selettore: la tua pagina 404, le schermate dell’account, il checkout. Le regole di visualizzazione condizionale di WPML ti permettono di nascondere il selettore per singola pagina senza ricorrere al CSS display:none nel tuo tema.

Puoi impostare le regole per singola pagina nella stessa pagina WPMLImpostazioniSelettori di lingua. Scegli le pagine in cui vuoi che il selettore sia nascosto; la regola si applica contemporaneamente a ogni posizionamento del selettore.

Conserva i parametri dell’URL

Quando un visitatore fa clic sul selettore, WPML ricostruisce l’URL per la lingua di destinazione. Per impostazione predefinita, i parametri della stringa di query (?utm_source=newsletter, parametri di filtro, ecc.) vengono eliminati. Questo interrompe le campagne di analisi e gli elenchi filtrati.

Il campo Conserva gli argomenti dell’URL elenca le chiavi di query che vuoi conservare durante il cambio di lingua. Tutto ciò che inserisci qui (una per riga) viaggia con il visitatore verso l’URL tradotto.

CSS personalizzato per il selettore

Una singola area di testo sotto CSS aggiuntivo applica lo stile a tutti i selettori del sito contemporaneamente. È utile per adattare il selettore al tuo tema senza toccare i file del tema.

Memorizzazione nella cache del template del selettore

WPML memorizza nella cache l’HTML renderizzato di ogni posizionamento del selettore, il che accelera il caricamento delle pagine su un sito molto trafficato. A partire da WPML 5.0 non c’è alcuna impostazione per questo: la cache è attiva ogni volta che la directory della cache di WPML è scrivibile.

L’inghippo: quando modifichi un’opzione del selettore e non vedi la modifica riflessa sul front-end, la cache è il primo posto da controllare. Esegui Svuota la cache su WPMLSupporto, quindi ricarica la pagina.

Selettori personalizzati nel codice del tema

Per i siti in cui i posizionamenti integrati non sono adatti (un selettore in una posizione specifica all’interno dell’header della pagina, un menu a discesa personalizzato renderizzato dal tuo tema, qualsiasi cosa al di fuori di un menu o di un’area widget di WordPress), WPML espone un’API che permette agli sviluppatori di temi di creare un selettore personalizzato.

La scheda Selettori di lingua personalizzati ha un interruttore Abilita e un pulsante Personalizza. Una volta abilitata, il codice del template del tema può renderizzare il selettore ovunque utilizzando l’API PHP documentata di WPML.

Scritto daAmir

Scritto daAmir