تقدم هذه الدليل نظرة تفصيلية على مفاتيح الاستبدال (Interpolation Keys) المستخدمة في تخصيص النصوص وقوالب رسائل البريد الإلكتروني للنظام في Discourse.
مستوى المستخدم المطلوب: مسؤول
أثناء تخصيص النصوص في Discourse أو تخصيص قوالب رسائل البريد الإلكتروني المحددة، قد تكون لاحظت وجود متغيرات نائبة متاحة في بعض القوالب.
في Discourse، نطلق على هذه المتغيرات اسم مفاتيح الاستبدال.
فهم مفاتيح الاستبدال
مفاتيح الاستبدال هي متغيرات نائبة متاحة في قوالب Discourse معينة. تتيح لك إدراج محتوى ديناميكي في نصوصك وقوالب رسائل البريد الإلكتروني.
مثال على مفاتيح الاستبدال لقالب رسالة البريد الإلكتروني Account Created:
سيتم استبدال هذه المفاتيح، مثل %{username} أو %{site_name}، بالبيانات الفعلية عند إرسال البريد الإلكتروني.
بشكل عام، يمكن نقل هذه المتغيرات النائبة داخل القالب الذي تنتمي إليه، لكنها متاحة فقط في ذلك القالب ولا يمكن نقلها إلى قوالب مختلفة، حيث تعتمد جميعها على كود الخادم المرتبط بالقالب المقابل.
ومع ذلك، تسمح مجموعات قوالب معينة بإضافة مفاتيح استبدال إضافية تتجاوز تلك الموجودة بالفعل في القالب الافتراضي.
مفاتيح استبدال إضافية
رسالة ترحيب المستخدم للنظام
لقوالب system_messages.welcome_user، يمكنك إضافة المفاتيح الإضافية التالية:
username: اسم مستخدم المستخدمname: الاسم الكامل للمستخدمname_or_username: إما الاسم الكامل للمستخدم أو اسم المستخدم
تُقدَّم هذه القيم بواسطة فئة SystemMessage أثناء التشغيل (راجع system_message.rb للكود المرتبط في Discourse).
رسائل البريد الإلكتروني لإشعارات المستخدمين
لقوالب user_notifications وقوالب البريد الإلكتروني ذات الصلة (بما في ذلك unsubscribe_mailing_list و unsubscribe_link)، تتوفر العديد من المفاتيح الإضافية، بما في ذلك topic_title و username و site_name و url و unsubscribe_url وغيرها.
للحصول على القائمة الكاملة والمحدثة لجميع مفاتيح الاستبدال المخصصة المسموح بها ومجموعات القوالب التي تنطبق عليها، راجع ALLOWED_CUSTOM_INTERPOLATION_KEYS في كود مصدر Discourse لملف translation_override.rb.
