• lokalizacja
  • internacjonalizacja
  • i18n
  • l10n
  • ui_locales
  • locale

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.

Charles
Charles
Developer

Przestań tracić tygodnie na uwierzytelnianie użytkowników
Uruchamiaj bezpieczne aplikacje szybciej z Logto. Zintegruj uwierzytelnianie użytkowników w kilka minut i skup się na swoim głównym produkcie.
Rozpocznij
Product screenshot

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 razie fr, w przeciwnym razie en).
  • 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:

  1. ui_locales (pierwszy obsługiwany tag)
  2. W przeciwnym razie automatyczne wykrywanie przez nagłówek HTTP Accept-Language
  3. 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.

Dokumentacja