Spersonalizuj swoje logowanie Logto za pomocą OIDC ui_locales
Spraw, aby Twoje doświadczenie logowania było natywne dla każdego użytkownika. W tym samouczku dowiesz się, jak używać standardowego parametru OIDC ui_locales do ustawienia języka interfejsu logowania Logto i powiązanych wiadomości e-mail w czasie rzeczywistym.
Dlaczego warto używać ui_locales?
Logto już obsługuje treści wielojęzyczne i automatyczne wykrywanie języka, ale są sytuacje, gdy chcesz jawnie wybrać język dla konkretnej interakcji:
- Produkty dla wielu organizacji z różnymi preferencjami językowymi dla każdej organizacji
- Głębokie linki z kampanii w określonym języku
- Strony produktów z lokalizowanymi CTA rozpoczynającymi logowanie w tym samym języku
- Testy A/B dla zlokalizowanego onboardingu
Poza tym ui_locales
to standardowy parametr obsługiwany przez wielu dostawców tożsamości i SDK.
Co robi ui_locales
- Ustawia język interfejsu logowania dla bieżącej interakcji (wygrywa pierwszy obsługiwany tag)
- Wpływa na lokalizację e-maili dla wiadomości wywołanych przez tę interakcję
- Udostępnia oryginalną wartość do szablonów e-maili jako zmienną
uiLocales
(np. "Żądane języki:{{uiLocales}}
")
Dowiedz się więcej w dokumentacji: Dokumentacja UI locales.
Wymagania wstępne
- Tenant Logto (Cloud lub OSS)
- Aplikacja zintegrowana z Logto (Szybki start)
- Co najmniej jeden dodatkowy język włączony w Doświadczeniu logowania (Zlokalizowane języki)
Opcjonalnie, ale przydatne:
- Własne szablony e-maili lub szablony zarządzane przez dostawcę, aby zobaczyć lokalizację e-maili w działaniu (Szablony e-maili)
Opcja 1: Użyj ui_locales przez SDK extraParams
SDK Logto pozwalają przekazać dodatkowe parametry OIDC podczas logowania. Dodaj ui_locales w extraParams
:
Uwagi:
- Podaj listę tagów BCP 47 oddzielonych spacją. Logto wybierze pierwszy tag istniejący w bibliotece językowej tenant'a (np.
fr-CA
, w przeciwnym raziefr
, w przeciwnym razieen
). - Działa dla pojedynczej interakcji — domyślny język tenant'a nie jest zmieniany.
- Możesz połączyć
ui_locales
z innymi standardowymi/niestandardowymi parametrami (np.login_hint
,organization_id
lub dyrektywami ekranu początkowego).
Opcja 2: Dodaj ui_locales do swojego adresu URL autoryzacji
Jeśli ręcznie budujesz żądanie autoryzacji OIDC (lub za pomocą ogólnego klienta OIDC), dodaj ui_locales
bezpośrednio:
Jak są lokalizowane e-maile
Gdy interakcja wywołuje wysłanie e-maila (np. kod weryfikacyjny), Logto rozstrzyga język w następującej kolejności:
ui_locales
(pierwszy obsługiwany tag)- W przeciwnym razie automatyczne wykrywanie przez nagłówek HTTP
Accept-Language
- W przeciwnym razie domyślny język tenant'a
Następnie Logto próbuje znaleźć niestandardowy szablon e-maila pasujący do rozstrzygniętego języka i rodzaju szablonu; jeśli żaden nie zostanie znaleziony, używany jest domyślny szablon konektora.
Szablony zarządzane przez dostawcę (np. Postmark, HTTP Email): Logto przekazuje zarówno uiLocales
, jak i locale
do Twojego dostawcy. Jeśli ui_locales
jest obecny, locale
korzysta z pierwszego obsługiwanego tagu z ui_locales
.
Zobacz: Lokalizacja szablonów e-maili.