Suomi
  • lokalisointi
  • kansainvälistäminen
  • i18n
  • l10n
  • ui_locales
  • locale

Lokaloi Logto-kirjautumiskokemus OIDC ui_locales -parametrin avulla

Tee kirjautumiskokemuksesta jokaiselle käyttäjälle aidosti paikallinen. Tässä ohjeessa opit käyttämään OIDC-standardi-parametria ui_locales asettaaksesi Logton kirjautumisnäkymän ja siihen liittyvien sähköpostien kielen reaaliajassa.

Charles
Charles
Developer

Lopeta viikkojen tuhlaaminen käyttäjien tunnistautumiseen
Julkaise turvallisia sovelluksia nopeammin Logtolla. Integroi käyttäjien tunnistautuminen minuuteissa ja keskity ydintuotteeseesi.
Aloita
Product screenshot

Miksi käyttää ui_locales?

Logto tukee jo useita kieliä ja automaattista tunnistusta, mutta joskus haluat valita kielen tietyssä tilanteessa:

  • Usean organisaation tuotteet, joissa jokaisella organisaatiolla on omat kieliasetukset
  • Kampanjoissa käytettyihin erityiskielisiin syvälinkkeihin
  • Tuotesivut, joilla on lokalisoituja CTA-painikkeita, jotka käynnistävät kirjautumisen samalla kielellä
  • Lokalisoitujen onboardingien A/B-testit

Lisäksi ui_locales on monien identiteettipalveluiden ja SDK:iden tukema standardiparametri.

Mitä ui_locales tekee

  • Asettaa kirjautumisnäkymän kielen kyseiseen tapahtumaan (ensimmäinen tuettu tunniste voittaa)
  • Vaikuttaa sähköpostiviestien lokalisointiin tämän tapahtuman laukaisevissa yhteyksissä
  • Paljastaa alkuperäisen arvon sähköpostipohjiin muuttujana uiLocales (esim. "Pyydetyt kielet: {{uiLocales}}")

Lue lisää viitteestä: UI locales -dokumentaatio.

Ennakkovaatimukset

  • Logto-yksikkö (Cloud tai OSS)
  • Sovellus, joka on integroitu Logton kanssa (Pika-aloitus)
  • Vähintään yksi lisäkieli aktivoitu kirjautumiskokemuksessa (Lokalisoidut kielet)

Valinnaista, mutta hyödyllistä:

  • Räätälöidyt sähköpostipohjat tai sähköpostipalveluntarjoajalla hallinnoidut pohjat lokalisointien kokeilemiseen (Sähköpostipohjat)

Vaihtoehto 1: Käytä ui_locales SDK:n extraParamsin kautta

Logto SDK:t mahdollistavat ylimääräisten OIDC-parametrien välittämisen kirjautumisen yhteydessä. Lisää ui_locales extraParams-kohtaan:

Huomioita:

  • Anna pilkulla eroteltu luettelo BCP 47 -tageja. Logto valitsee ensimmäisen tunnisteen, joka löytyy yksikkösi kielikirjastosta (esim. fr-CA, muuten fr, muuten en).
  • Vaikuttaa vain yhteen kirjautumiskertaan—yksikkösi oletuskieltä ei muuteta.
  • Voit yhdistää ui_locales-parametrin muihin standardi- tai mukautettuihin parametreihin (esim. login_hint, organization_id tai ensimmäisen näytön määreet).

Vaihtoehto 2: Lisää ui_locales valtuutus-osoitteeseen

Jos rakennat OIDC valtuutuspyynnön manuaalisesti (tai käytät geneeristä OIDC-asiakasta), lisää ui_locales suoraan:

Näin sähköpostit lokalisoidaan

Kun toiminto käynnistää sähköpostin (esim. vahvistuskoodi), Logto ratkaisee kielen seuraavassa järjestyksessä:

  1. ui_locales (ensimmäinen tuettu tunniste)
  2. Muuten tunnistetaan automaattisesti HTTP:n Accept-Language-otsikon perusteella
  3. Muuten käytetään yksikön oletuskieltä

Sen jälkeen Logto etsii sähköpostipohjaa, joka vastaa ratkaistua kieltä ja pohjatyyppiä; ellei löydy, käytetään yhdysliikennepalvelun oletuspohjaa.

Palveluntarjoajan hallinnoimat pohjat (esim. Postmark, HTTP Email): Logto välittää sekä uiLocales että locale palvelullesi. Jos ui_locales on läsnä, locale käyttää ensimmäistä tuettua tunnistetta ui_locales:sta.

Katso: Sähköpostipohjan lokalisointi.

Viitteet