Come tradurre un'applicazione privata con Weglot
In questo articolo imparerete a utilizzare Weglot in un'applicazione web privata (come un SaaS), consentendo di memorizzare e utilizzare la lingua preferita di ciascun utente, senza affidarsi a URL specifici per la lingua.
Come funziona
Per impostazione predefinita, Weglot utilizza le sottodirectory per visualizzare le traduzioni:
- Pagina originale:
https://www.example.com/about
Versione francese:
https://www.example.com/fr/about
Tuttavia, per le applicazioni private come gli strumenti SaaS, si potrebbe voler cambiare lingua in base alle preferenze dell'utente, senza modificare l'URL.
Questo approccio è comunemente utilizzato da piattaforme come Notion, Stripe, Facebook e X (ex Twitter), dove la lingua viene salvata nel profilo dell'utente.
Weglot può supportare questa impostazione tramite una configurazione personalizzata. Ecco come fare.
Prerequisiti
Per implementare ciò, l'applicazione deve essere in grado di memorizzare e richiamare la lingua preferita da ciascun utente.
Procedere come segue:
Memorizzare la lingua preferita nei profili utente
Creare una proprietà nel database degli utenti (ad esempio, una colonna come language_code) per memorizzare il codice di 2 lettere della lingua selezionata da ciascun utente.
Aggiungere un commutatore di lingua
Lasciate che i vostri utenti scelgano la loro lingua preferita tramite un menu a tendina, ad esempio nella pagina del loro account o del loro profilo.
Inviare un'intestazione di risposta HTTP personalizzata
Ogni volta che viene caricata una pagina per un utente connesso, includere la seguente intestazione di risposta HTTP:
Weglot-Language-Preference: fr
(Sostituire fr con il codice di 2 lettere relativo alla lingua selezionata).
È possibile ispezionare l'intestazione utilizzando Chrome DevTools > scheda Rete. Ecco un esempio di come dovrebbe apparire questa intestazione:
Installazione
Una volta che l'applicazione web include l'opzione Weglot-Language-Preference
è possibile procedere con l'installazione di Weglot.
Impostare Weglot utilizzando un'integrazione di sottodirectory
Seguire i passaggi standard di installazione di Weglot utilizzando il metodo della "sottodirectory".
Verificare che le sottodirectory delle lingue siano funzionanti
Assicuratevi che le vostre traduzioni siano accessibili attraverso URL come /fr/, /de/, ecc.
Contatta il nostro team di assistenza
Una volta configurato il tutto, inviateci un messaggio all'indirizzo support@weglot.com.
Chiedeteci di attivare la modalità Applicazione privata sul vostro progetto.
Una volta attivato, Weglot utilizzerà il
Weglot-Language-Preference
invece del percorso dell'URL per determinare la lingua da visualizzare.