العربية
  • localization
  • internationalization
  • i18n
  • l10n
  • ui_locales
  • locale

خصص تجربة تسجيل الدخول إلى Logto حسب لغتك باستخدام OIDC ui_locales

اجعل تجربة تسجيل الدخول تبدو مألوفة وطبيعية لكل مستخدم. في هذا الدليل، ستتعلم كيفية استخدام معلمة OIDC القياسية ui_locales لتحديد لغة واجهة مستخدم تسجيل الدخول في Logto ورسائل البريد الإلكتروني ذات الصلة في وقت التشغيل.

Charles
Charles
Developer

توقف عن إضاعة أسابيع في مصادقة المستخدم
أطلق تطبيقات آمنة بشكل أسرع مع Logto. قم بدمج مصادقة المستخدم في دقائق وركز على منتجك الأساسي.
ابدأ الآن
Product screenshot

لماذا تستخدم ui_locales؟

يدعم Logto بالفعل لغات متعددة والكشف التلقائي عن اللغة، لكن أحيانًا تحتاج لاختيار اللغة بشكل صريح لتفاعل معين:

  • منتجات متعددة المؤسسات مع تفضيلات لغوية مختلفة لكل مؤسسة
  • روابط حملات دعائية بلغة محددة
  • صفحات المنتجات مع أزرار دعوة لاتخاذ إجراء (CTA) مُحلية تبدأ تسجيل الدخول بنفس اللغة
  • اختبارات A/B لتجربة مستخدم مُحلية

بالإضافة إلى ذلك، فإن ui_locales هي معلمة قياسية تدعمها العديد من مزودي الهوية وحزم التطوير (SDKs).

ماذا تفعل ui_locales

  • تحدد لغة واجهة مستخدم تسجيل الدخول لهذا التفاعل (تفوز أول علامة مدعومة)
  • تؤثر على تعريب رسائل البريد الإلكتروني الناجمة عن هذا التفاعل
  • تتيح القيمة الأصلية لقوالب البريد الإلكتروني كمتغير uiLocales (مثلاً: "اللغات المطلوبة: {{uiLocales}}")

للمزيد، راجع المرجع: مستندات واجهة مستخدم اللغات.

المتطلبات المسبقة

اختياري لكن مفيد:

  • تمكين قوالب بريد إلكتروني مخصصة أو قوالب مُدارة من طرف المزود لرؤية تعريب البريد الإلكتروني عمليًا (قوالب البريد الإلكتروني)

الخيار الأول: استخدام 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 اللغة بهذا الترتيب:

  1. ui_locales (أول علامة مدعومة)
  2. وإلا، يتم الاكتشاف التلقائي عبر ترويسة HTTP Accept-Language
  3. وإلا، لغة العميل الافتراضية

بعدها، يحاول Logto إيجاد قالب بريد إلكتروني مخصص يطابق اللغة والنوع المقررين؛ إذا لم يتم العثور عليه، يعود إلى القالب الافتراضي للموفر.

القوالب المُدارة من المزود (مثلاً، Postmark، البريد الإلكتروني عبر HTTP): يرسل Logto كل من uiLocales و locale إلى مزود الخدمة. إذا كانت ui_locales موجودة، يستخدم locale أول علامة مدعومة من ui_locales.

انظر: تعريب قوالب البريد الإلكتروني.

المرجع