Lingua del banner su siti multilingua
Il banner può mostrare i testi nella lingua della pagina, con un'impostazione della dashboard. Questa pagina spiega come funziona e quali lingue esistono.
Prerequisiti
Prima di cominciare controlla che:
- il banner sia installato nella pagina. Vedi Snippet HTML;
- ogni pagina abbia l'attributo
langsull'elemento<html>, per esempio<html lang="fr">; - la lingua della pagina sia tra le lingue attive dello spazio web nella dashboard. Con una lingua non attiva il banner usa l'inglese, se è tra le lingue attive, altrimenti la lingua principale.
Il rilevamento automatico
Il rilevamento si attiva nella dashboard con Cambia automaticamente la lingua del banner, in Gestione testi, alla voce Preferenze lingue. Le istruzioni sono nella guida Cookie banner.
Con l'impostazione attiva il banner si comporta così:
- legge l'attributo
langdell'elemento<html>all'avvio e segue ogni cambio successivo; - usa le prime due lettere in minuscolo. Con
pt-BRusapt, conzh-Hantusazh, conen-USusaen; - se la lingua è tra le lingue attive dello spazio web, mostra i testi di quella lingua. Se non hai personalizzato i testi di quella lingua, usa i testi predefiniti di Avacy;
- se la lingua non è tra le lingue attive, usa l'inglese, se è tra le lingue attive, altrimenti la lingua principale dello spazio web;
- all'avvio, se
langè vuoto o manca, usa la lingua principale dello spazio web. Selangdiventa vuoto dopo, la lingua non cambia.
Con l'impostazione spenta il banner usa sempre la lingua principale dello spazio web, qualunque sia lang.
Le lingue disponibili
Il banner include nel codice tre lingue, en, it e de. Altre 32 lingue arrivano dai file della versione del banner, e con lo snippet HTML il banner scarica da solo il file che serve.
| Gruppo | Codici |
|---|---|
| Incluse nel banner | en, it, de |
| Scaricate dai file della versione | ar, bg, bs, ca, cs, cy, da, el, es, eu, fi, fr, gl, he, hr, hu, id, ja, ko, lt, lv, mk, mt, nl, no, pl, pt, ro, ru, sl, uk, zh |
Per una lingua attiva nello spazio web ma assente dalla tabella, per esempio tr o sv, il banner mostra i testi in inglese, così non mescola due lingue. Con un codice di lingua valido la console del browser segnala un errore sul file della lingua, di solito 403 o 404.
Per le lingue attive il banner usa i testi predefiniti, anche se non hai personalizzato i testi nella dashboard. I testi personalizzati valgono per la lingua in cui li hai scritti.
Step
- Attiva nella dashboard le lingue del sito, in Gestione lingue.
- Imposta l'attributo
langsu ogni pagina, per esempio<html lang="fr">. - Nella dashboard attiva Cambia automaticamente la lingua del banner, come spiega la guida Cookie banner.
- Pubblica la modifica sul sito.
Quando cambi le lingue attive o la lingua principale in Gestione lingue, la dashboard ripubblica il banner da sola. Il banner usa la lista nuova dalla visita successiva, senza un'altra pubblicazione.
Cambiare lingua da codice
Se il sito non aggiorna lang, per esempio in un'applicazione a pagina singola, cambia la lingua del banner con window.Avacy.changeLanguage.
window.Avacy.changeLanguage('fr');
Come funziona la chiamata:
- accetta anche
fr-FR,fr_FRoFR: il banner usa le prime due lettere in minuscolo; - con un valore che non è un codice di lingua, per esempio
xxo una stringa vuota, la lingua non cambia e la console mostra un avviso[Avacy] changeLanguage. La chiamata non lancia errori; - quando la lingua cambia parte l'evento
avacy:language-changed(vedi Eventi del banner); - il cambio non resta dopo il ricaricamento della pagina: all'avvio il banner riparte dalla lingua principale o, con il rilevamento automatico, da
lang; - con il rilevamento automatico attivo vale l'ultimo cambio, tra
changeLanguagee un cambio successivo dilang.
Valgono le stesse regole del rilevamento automatico. Con una lingua non attiva nello spazio web il banner usa l'inglese, se è tra le lingue attive, altrimenti la lingua principale. Con una lingua attiva senza file di testi, per esempio sv, mostra l'inglese.
Verifica
- Apri il sito in una finestra privata. Il banner compare e i testi sono nella lingua della pagina.
- Cambia la lingua del sito con una lingua attiva. Anche i testi del banner cambiano.
- Apri una pagina con una lingua non attiva. Il banner è in inglese, se l'inglese è tra le lingue attive, altrimenti nella lingua principale.
Problemi comuni
I problemi più frequenti:
- Il banner è in italiano su una pagina in un'altra lingua: controlla che Cambia automaticamente la lingua del banner sia attiva e che
<html>abbia l'attributolang. Controlla anche che la lingua della pagina sia attiva nello spazio web: con una lingua non attiva il banner usa l'inglese, se è tra le lingue attive, altrimenti la lingua principale; - Il banner è in inglese o nella lingua principale invece che nella lingua della pagina: la lingua della pagina non è attiva nello spazio web. Attivala nella dashboard, in Gestione lingue, come spiega la guida per attivare una lingua. La dashboard ripubblica il banner da sola;
- Il banner è in inglese su una pagina in un'altra lingua attiva: la lingua non è nella tabella, oppure il file della lingua non si è scaricato (errore 403 o 404 nella console).
Ultimo aggiornamento: 09/11/2026.