Logto giriş deneyimini OIDC ui_locales ile yerelleştir

Neden ui_locales kullanılır?#

Logto zaten çoklu dil desteği ve otomatik algılama sağlıyor, ancak bazı durumlarda belirli bir etkileşim için dili açıkça seçmek isteyebilirsin:

• Her organizasyon için farklı dil tercihlerine sahip çoklu organizasyon ürünleri
• Belirli bir dildeki kampanyalardan gelen derin bağlantılar
• Lokalize edilmiş CTA’ları olan ve aynı dilde giriş başlatan ürün sayfaları
• Yerelleştirilmiş onboarding için A/B testleri

Ayrıca, ui_locales birçok kimlik sağlayıcısı ve SDK tarafından desteklenen standart bir parametredir.

ui_locales ne yapar?#

• Mevcut etkileşim için (ilk desteklenen etiket kazanır) giriş UI’sının dilini ayarlar
• Bu etkileşim tarafından tetiklenen mesajlar için e-posta yerelleştirmesini etkiler
• Orijinal değeri e-posta şablonlarına uiLocales değişkeni olarak sunar (ör. "Talep edilen diller: {{uiLocales}}")

Daha fazla bilgi için referansa bak: UI locales belgeleri.

Ön koşullar#

• Bir Logto tenant’ı (Bulut veya OSS)
• Logto ile entegre bir uygulama (Hızlı başlangıçlar)
• Giriş Deneyimi'nde etkinleştirilmiş en az bir ek dil (Yerelleştirilmiş diller)

İsteğe bağlı ama kullanışlı:

• E-posta yerelleştirmesini görmek için özel e-posta şablonları veya sağlayıcı yönetimli şablonlar etkin (E-posta şablonları)

Seçenek 1: SDK extraParams ile ui_locales kullan#

Logto SDK’ları, giriş sırasında ekstra OIDC parametreleri geçirmeni sağlar. extraParams içine ui_locales ekle:

Notlar:

• Bir aralıklı BCP 47 etiketleri listesi ver. Logto, tenant’ının dil kütüphanesinde bulunan ilk etiketi seçer (ör. fr-CA, yoksa fr, yoksa en).
• Her etkileşim için çalışır—tenant’ının varsayılan dili değişmez.
• ui_locales'u diğer standart/özel parametrelerle birleştirebilirsin (örneğin, login_hint, organization_id veya ilk ekran direktifleriyle).

Seçenek 2: authorize URL’ne ui_locales ekle#

Eğer OIDC yetkilendirme isteğini elle (veya genel bir OIDC istemcisiyle) düzenliyorsan, doğrudan ui_locales ekle:

E-postalar nasıl yerelleştirilir#

Bir etkileşim bir e-posta tetiklediğinde (örneğin, doğrulama kodu), Logto şu sırayla dili çözer:

1. ui_locales (ilk desteklenen etiket)
2. Aksi halde HTTP Accept-Language başlığı ile otomatik algılama
3. Aksi halde tenant varsayılan dili

Daha sonra Logto, çözümlenen dil ve şablon tipine uygun özel bir e-posta şablonu bulmaya çalışır; eğer bulunamazsa, bağlayıcı varsayılanına döner.

Sağlayıcı yönetimli şablonlar (ör. Postmark, HTTP Email): Logto hem uiLocales hem de locale'u sağlayıcına iletir. Eğer ui_locales mevcutsa, locale, ui_locales'dan ilk desteklenen etiketi kullanır.

Bakınız: E-posta şablonu yerelleştirme.

Referanslar#

• UI locales belgeleri
• Yerelleştirilmiş diller
• E-posta şablonları
• OIDC Temel – ui_locales