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.
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
, muutenfr
, muutenen
). - 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ä:
ui_locales
(ensimmäinen tuettu tunniste)- Muuten tunnistetaan automaattisesti HTTP:n
Accept-Language
-otsikon perusteella - 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.