خصص تجربة تسجيل الدخول إلى Logto حسب لغتك باستخدام OIDC ui_locales
اجعل تجربة تسجيل الدخول تبدو مألوفة وطبيعية لكل مستخدم. في هذا الدليل، ستتعلم كيفية استخدام معلمة OIDC القياسية ui_locales لتحديد لغة واجهة مستخدم تسجيل الدخول في Logto ورسائل البريد الإلكتروني ذات الصلة في وقت التشغيل.
لماذا تستخدم ui_locales؟
يدعم Logto بالفعل لغات متعددة والكشف التلقائي عن اللغة، لكن أحيانًا تحتاج لاختيار اللغة بشكل صريح لتفاعل معين:
- منتجات متعددة المؤسسات مع تفضيلات لغوية مختلفة لكل مؤسسة
- روابط حملات دعائية بلغة محددة
- صفحات المنتجات مع أزرار دعوة لاتخاذ إجراء (CTA) مُحلية تبدأ تسجيل الدخول بنفس اللغة
- اختبارات A/B لتجربة مستخدم مُحلية
بالإضافة إلى ذلك، فإن ui_locales
هي معلمة قياسية تدعمها العديد من مزودي الهوية وحزم التطوير (SDKs).
ماذا تفعل ui_locales
- تحدد لغة واجهة مستخدم تسجيل الدخول لهذا التفاعل (تفوز أول علامة مدعومة)
- تؤثر على تعريب رسائل البريد الإلكتروني الناجمة عن هذا التفاعل
- تتيح القيمة الأصلية لقوالب البريد الإلكتروني كمتغير
uiLocales
(مثلاً: "اللغات المطلوبة:{{uiLocales}}
")
للمزيد، راجع المرجع: مستندات واجهة مستخدم اللغات.
المتطلبات المسبقة
- عميل Logto (سحابي أو مفتوح المصدر)
- تطبيق مدمج مع Logto (البدء السريع)
- تمكين لغة إضافية واحدة على الأقل في تجربة تسجيل الدخول (اللغات المحلية)
اختياري لكن مفيد:
- تمكين قوالب بريد إلكتروني مخصصة أو قوالب مُدارة من طرف المزود لرؤية تعريب البريد الإلكتروني عمليًا (قوالب البريد الإلكتروني)
الخيار الأول: استخدام ui_locales عبر extraParams في SDK
تتيح حزم تطوير Logto لك تمرير معلمات OIDC إضافية أثناء تسجيل الدخول. أضف ui_locales في extraParams
:
ملاحظات:
- أدخل قائمة بعلامات BCP 47 مفصولة بمسافة. سيختار Logto أول علامة موجودة في مكتبة اللغات في العميل الخاص بك (مثلاً،
fr-CA
، أوfr
، أوen
). - يعمل لكل تفاعل على حدة — لا يتم تغيير اللغة الافتراضية للعميل.
- يمكنك دمج
ui_locales
مع معلمات قياسية/مخصصة أخرى (مثلاً،login_hint
,organization_id
، أو توجيهات الشاشة الأولى).
الخيار الثاني: إضافة ui_locales إلى رابط التفويض الخاص بك
إذا كنت تنشئ طلب تفويض OIDC يدويًا (أو عبر عميل OIDC عام)، أضف ui_locales
مباشرةً:
كيف يتم تعريب رسائل البريد الإلكتروني
عندما يؤدي التفاعل إلى إرسال بريد إلكتروني (مثلاً، رمز تحقق)، يحدد Logto اللغة بهذا الترتيب:
ui_locales
(أول علامة مدعومة)- وإلا، يتم الاكتشاف التلقائي عبر ترويسة HTTP
Accept-Language
- وإلا، لغة العميل الافتراضية
بعدها، يحاول Logto إيجاد قالب بريد إلكتروني مخصص يطابق اللغة والنوع المقررين؛ إذا لم يتم العثور عليه، يعود إلى القالب الافتراضي للموفر.
القوالب المُدارة من المزود (مثلاً، Postmark، البريد الإلكتروني عبر HTTP): يرسل Logto كل من uiLocales
و locale
إلى مزود الخدمة. إذا كانت ui_locales
موجودة، يستخدم locale
أول علامة مدعومة من ui_locales
.
انظر: تعريب قوالب البريد الإلكتروني.