مفاتيح الاستيفاء لتخصيص نصوص وقوالب البريد الإلكتروني للنظام

[Discourse]

يوفر هذا الدليل نظرة عامة مفصلة على مفاتيح الاستيفاء المستخدمة لتخصيص قوالب النصوص ورسائل البريد الإلكتروني للنظام في Discourse.

مستوى المستخدم المطلوب: مسؤول

أثناء تخصيص النصوص في Discourse أو تخصيص قوالب البريد الإلكتروني المحددة، قد تكون لاحظت أن هناك متغيرات عناصر نائبة متاحة في بعض القوالب.

في Discourse، نسمي هذه مفاتيح الاستيفاء.

فهم مفاتيح الاستيفاء

مفاتيح الاستيفاء هي عناصر نائبة متاحة في قوالب Discourse معينة. تسمح لك بإدراج محتوى ديناميكي في قوالب النصوص ورسائل البريد الإلكتروني الخاصة بك.

مثال على مفاتيح الاستيفاء لقالب البريد الإلكتروني Account Created:

سيتم استبدال هذه المفاتيح، مثل %{username} أو %{site_name}، ببيانات فعلية عند إرسال البريد الإلكتروني.

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

ومع ذلك، هناك بعض مفاتيح الاستيفاء الإضافية المسموح بها في قوالب النصوص ورسائل البريد الإلكتروني.

مفاتيح الاستيفاء العامة

إليك قائمة ببعض مفاتيح الاستيفاء العامة التي يمكنك استخدامها عبر جميع قوالب البريد الإلكتروني:

• username: اسم المستخدم للمستخدم
• name: الاسم الكامل للمستخدم
• name_or_username: إما الاسم الكامل للمستخدم أو اسم المستخدم الخاص به

يمكنك أيضًا استخدام جميع مفاتيح system_messages.welcome_user في تخصيصات قوالب النصوص ورسائل البريد الإلكتروني طالما أن لديها مفاتيح فرعية subject_template و text_body_template، لأنها جميعًا يجب أن تتم معالجتها بواسطة فئة SystemMessage (انظر system_message.rb للكود المتعلق بـ Discourse).

للحصول على قائمة كاملة بمفاتيح الاستيفاء المخصصة المسموح بها، راجع ALLOWED_CUSTOM_INTERPOLATION_KEYS في كود مصدر Discourse لـ translation_override.rb.

[gerhard (Gerhard Schlager)]

@SaraDev

يمكنك استخدام جميع مفاتيح system_messages.* في تخصيصات قوالب النصوص والبريد الإلكتروني طالما أن لديها مفاتيح فرعية subject_template و text_body_template - لأن كل هذه يجب التعامل معها بواسطة فئة SystemMessage التي تضيف username, name, name_or_username كمفاتيح استيفاء إضافية. انظر system_message.rb للكود المتعلق بـ Discourse.

هذا ليس صحيحًا. حاليًا، يعمل هذا فقط مع system_messages.welcome_user، ولكن يمكننا توسيعه ليشمل جميع المفاتيح الأخرى. هذه مادة مناسبة لـ pr-welcome.

[SaraDev (Sara Devlaeminck)]

شكراً لتنبيهك، تم تحديث ذلك في الدليل.

[gassim (Al-Gassim Sharaf Addin)]

مرحباً!

كيف يمكنني تعديل قيمة بعض مفاتيح الاستيفاء هذه؟ على سبيل المثال، %{search_answer}

شكراً!

[gassim (Al-Gassim Sharaf Addin)]

@Discourse

username: اسم المستخدم الخاص بالمستخدم

مرحباً!
يقول أن هذا المفتاح غير صالح:

ملاحظة:
أنا أستبدل في النص وليس البريد الإلكتروني (هل هذا يحدث فرقاً)؟ شكراً!

[Jagster (Jakke Lehtonen)]

لا أعتقد أن هذه عالمية ومتاحة للاستخدام في كل مكان.

[gassim (Al-Gassim Sharaf Addin)]

@Discourse

يمكنك أيضًا استخدام جميع مفاتيح system_messages.welcome_user في تخصيصات قوالب النصوص والبريد الإلكتروني

شكرًا لك @Jagster! أنا أستخدمها في تخصيص النص، لذا بناءً على المنشور، هل من المفترض أن تعمل؟

[Jagster (Jakke Lehtonen)]

الموضوع يتعلق بالفعل بقوالب البريد الإلكتروني وهذه النصوص. لذلك، لا يمكنك استخدام مفاتيح الاستيفاء خارج السياق الصحيح. لهذا السبب لدينا مفاتيح أخرى للبريد الإلكتروني، وأخرى لبعض مطالبات الذكاء الاصطناعي وما إلى ذلك.

بالتأكيد، يمكن للمكونات الإضافية القيام بالكثير من الأشياء، ولكن هذه المرة ليس بشكل مباشر.

وإخلاء مسؤولية: أنا مجرد مستخدم نهائي آخر وقد أكون مخطئًا بشكل فظيع أيضًا. لكنني متأكد تمامًا من أنني على حق - وهذا هو سبب عدم نجاح محاولتك

[gassim (Al-Gassim Sharaf Addin)]

حسنًا، شكرًا جزيلاً لدعمك. يبدو أنه لا يعمل حتى عند استخدامه في قالب بريد إلكتروني:

[Jagster (Jakke Lehtonen)]

رهاني هو أنه يمكنك استخدام %{username} في قوالب “قام المستخدم بـ…”، وجميع القوالب الأخرى لا تدعمه.

لكن سنرى غدًا عندما يستيقظ جميع الخبراء.