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.
CharlesDeveloper
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.
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:
När en händelse utlöser ett e-postmeddelande (t.ex. verifieringskod), avgör Logto språk i denna ordning:
ui_locales (första stödda taggen)
Annars automatiskt via HTTP-headern Accept-Language
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.
