Svenska
  • lokalisering
  • internationellisering
  • i18n
  • l10n
  • ui_locales
  • locale

Anpassa din Logto-inloggningsupplevelse med OIDC ui_locales

Gör din inloggningsupplevelse naturlig för varje användare. I denna guide lär du dig hur du använder den standardiserade OIDC-parametern ui_locales för att ställa in språket i Logtos inloggningsgränssnitt och tillhörande e-postmeddelanden i realtid.

Charles
Charles
Developer

Sluta slösa veckor på användarautentisering
Lansera säkra appar snabbare med Logto. Integrera användarautentisering på några minuter och fokusera på din kärnprodukt.
Kom igång
Product screenshot

Varför använda ui_locales?

Logto stöder redan flerspråkigt innehåll och automatisk språkigenkänning, men ibland vill du välja språk för ett specifikt tillfälle:

  • Flera organisationer i samma produkt med olika språkinställningar per organisation
  • Djupa länkar från kampanjer på ett specifikt språk
  • Produktsidor med lokala "Call to Action"-knappar (CTA) som startar inloggning på samma språk
  • A/B-tester för lokal onboarding

Dessutom är ui_locales en standardparameter som stöds av många identitetsleverantörer och SDK:er.

Vad ui_locales gör

  • Ställer in språk för inloggningsgränssnittet vid denna interaktion (den första stödda taggen väljs)
  • Påverkar vilka språk e-postmeddelanden skickas på för denna interaktion
  • Exponerar ursprungsvärdet till e-postmallar som variabeln uiLocales (exempel: "Begärda språk: {{uiLocales}}")

Läs mer i referensen: UI locales-dokumentation.

Förutsättningar

  • En Logto-hyresgäst (Cloud eller OSS)
  • En applikation integrerad med Logto (Snabbstart)
  • Minst ett ytterligare språk aktiverat i inloggningsupplevelsen (Lokaliserade språk)

Valfritt men praktiskt:

  • Anpassade e-postmallar eller leverantörshanterade mallar aktiverade, för att se e-postlokalisering i praktiken (E-postmallar)

Alternativ 1: Använd ui_locales via SDK extraParams

Logto SDK:er låter dig skicka extra OIDC-parametrar vid inloggning. Lägg till ui_locales i extraParams:

Att tänka på:

  • Skriv en lista med mellanslag mellan BCP 47-taggar. Logto väljer den första taggen som existerar i din hyresgästs språkbibliotek (till exempel fr-CA, annars fr, annars en).
  • Gäller per interaktion – hyresgästens standardspråk ändras inte.
  • Du kan kombinera ui_locales med andra standard- eller anpassade parametrar (till exempel login_hint, organization_id, eller direktiv för första vyn).

Alternativ 2: Lägg till ui_locales direkt i authorize-URL:en

Om du manuellt bygger en OIDC-auktoriseringsbegäran (eller med en generell OIDC-klient), lägg till ui_locales direkt:

Så här lokaliseras e-post

När en händelse utlöser ett e-postmeddelande (t.ex. verifieringskod), avgör Logto språk i denna ordning:

  1. ui_locales (första stödda taggen)
  2. Annars automatiskt via HTTP-headern Accept-Language
  3. Annars hyresgäststandard

Därefter försöker Logto hitta en anpassad e-postmall som matchar det valda språket och malltypen; om ingen hittas används standardmallen för connectorn.

Leverantörshanterade mallar (till exempel Postmark, HTTP Email): Logto skickar både uiLocales och locale till leverantören. Om ui_locales är ifyllt, använder locale den första stödda taggen från ui_locales.

Se: Lokaliserade e-postmallar.

Referens

Prova Logto Cloud gratis