Lokaliseer je Logto aanmeldervaring met OIDC ui_locales
Laat je aanmeldervaring als native aanvoelen voor elke gebruiker. In deze tutorial leer je hoe je de standaard OIDC-parameter ui_locales gebruikt om de runtime-taal van Logto's aanmeld-UI en gerelateerde e-mails in te stellen.
Waarom ui_locales gebruiken?
Logto ondersteunt al meertalige inhoud en automatische detectie, maar soms wil je expliciet de taal kiezen voor een specifieke interactie:
- Multi-organisatie producten met verschillende taalvoorkeuren per organisatie
- Directe links vanuit campagnes in een specifieke taal
- Productpagina's met gelokaliseerde CTA's die het aanmelden in dezelfde taal starten
- A/B-tests voor gelokaliseerde onboarding
Daarnaast is ui_locales
een standaardparameter die door veel identiteitsproviders en SDK's wordt ondersteund.
Wat doet ui_locales
- Stelt de taal van de aanmeld-UI in voor de huidige interactie (de eerst ondersteunde tag wordt gebruikt)
- Beïnvloedt de lokalisatie van e-mails voor berichten die door deze interactie worden geactiveerd
- Stelt de oorspronkelijke waarde bloot aan e-mailsjablonen als variabele
uiLocales
(bijv. "Aangevraagde talen:{{uiLocales}}
")
Lees meer in de referentie: UI locales docs.
Vereisten
- Een Logto-tenant (Cloud of OSS)
- Een applicatie geïntegreerd met Logto (Quick-starts)
- Minstens één extra taal ingeschakeld in Aanmeldervaring (Gelokaliseerde talen)
Optioneel maar handig:
- Aangepaste e-mailsjablonen of door de provider beheerde sjablonen ingeschakeld, om e-mail lokalisatie in actie te zien (E-mailsjablonen)
Optie 1: Gebruik ui_locales via SDK extraParams
Logto SDK's laten je extra OIDC-parameters meegeven tijdens het aanmelden. Voeg ui_locales toe in extraParams
:
Opmerkingen:
- Geef een lijst van spatiegescheiden BCP 47-tags. Logto kiest de eerste tag die in de taalbibliotheek van je tenant bestaat (bijv.
fr-CA
, andersfr
, andersen
). - Werkt per interactie—de standaardtaal van je tenant wordt niet gewijzigd.
- Je kunt
ui_locales
combineren met andere standaard/aangepaste parameters (zoalslogin_hint
,organization_id
of aanwijzingen voor het eerste scherm).
Optie 2: Voeg ui_locales toe aan je authorize URL
Als je het OIDC-autorisatieverzoek handmatig maakt (of via een generieke OIDC-client), voeg ui_locales
direct toe:
Hoe e-mails gelokaliseerd worden
Wanneer een interactie een e-mail activeert (bijvoorbeeld een verificatiecode), bepaalt Logto de taal in deze volgorde:
ui_locales
(eerste ondersteunde tag)- Anders automatisch detecteren via HTTP
Accept-Language
header - Anders de standaardtaal van de tenant
Daarna probeert Logto een aangepast e-mailsjabloon te vinden die overeenkomt met de bepaalde taal en sjabloontype; als er geen wordt gevonden, wordt teruggevallen op de standaard van de connector.
Door de provider beheerde sjablonen (bijv. Postmark, HTTP Email): Logto geeft zowel uiLocales
als locale
door aan je provider. Als ui_locales
aanwezig is, gebruikt locale
de eerst ondersteunde tag uit ui_locales
.
Zie: E-mailsjabloonlokalisatie.