Nederlands
  • lokalisatie
  • internationalisering
  • i18n
  • l10n
  • ui_locales
  • locale

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.

Charles
Charles
Developer

Stop met weken verspillen aan gebruikersauthenticatie
Lanceer veilige apps sneller met Logto. Integreer gebruikersauthenticatie in minuten en focus op je kernproduct.
Aan de slag
Product screenshot

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, anders fr, anders en).
  • Werkt per interactie—de standaardtaal van je tenant wordt niet gewijzigd.
  • Je kunt ui_locales combineren met andere standaard/aangepaste parameters (zoals login_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:

  1. ui_locales (eerste ondersteunde tag)
  2. Anders automatisch detecteren via HTTP Accept-Language header
  3. 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.

Referentie