 |
الملخص | يسمح Discourse Templates بإنشاء قوالب محتوى للاستخدام المتكرر. يتم تخزين القوالب كعناوين في فئة خاصة، حيث يمكن تعديلها ومناقشتها حسب الحاجة. |
 |
دليل التثبيت | هذا البرنامج المساعد مدمج في نواة Discourse. لا حاجة لتثبيت البرنامج المساعد بشكل منفصل. |
هذا البرنامج المساعد هو في الأساس نسخة جديدة من Discourse Canned Replies ولكنه أكثر مرونة ويخزن القوالب بطريقة مختلفة.
الميزات
يستخدم هذا البرنامج المساعد فئة واحدة أو أكثر لتخزين القوالب للاستخدام لاحقًا. سيتم استخدام المنشور الأول في كل عنوان في هذه الفئات كقالب للردود.
يوفر هذا النهج وظائف أكثر بكثير مما كان متاحًا سابقًا مع discourse-canned-replies حيث سيكون لكل قالب سجل تعديلات، ويمكن أن يكون له وسوم مرتبطة، ويمكن استخدام المنشورات اللاحقة لمناقشة محتوى القالب إذا لزم الأمر.
سيتم استخدام العناوين المرئية فقط كقوالب، لذا لن يتم سرد العناوين غير المدرجة والأرشيفية.
يستفيد البرنامج المساعد أيضًا من إعدادات أمان الفئات للتحقق من المستخدمين الذين يمكنهم استخدام القوالب. إذا كان بإمكان المستخدم قراءة العناوين في الفئة، فسيكون خيار “إدراج القوالب” في محرر النصوص متاحًا للاستخدام. لن يتمكن المستخدم من رؤية القوالب/العناوين في الفئات التي لا يملك وصولاً إليها.
يمكن استخدام عدة فئات رئيسية و/أو فئات فرعية لتوفير مجموعات مختلفة من القوالب لمجموعات مختلفة من المستخدمين وتنظيم القوالب.
القوالب الخاصة
يدعم البرنامج المساعد أيضًا القوالب الخاصة. القوالب الخاصة هي رسائل خاصة موسومة كقوالب. ستكون هذه الرسائل متاحة كقوالب فقط لمؤلف الرسالة.
لن يتم سرد الرسائل الأرشيفية كقوالب.
يمكنك العثور على جميع قوالبك الخاصة في:
/u/{USER-NAME}/messages/tags/{PRIVATE-TEMPLATE-TAG}
الإعدادات:
discourse templates enabled: تفعيل البرنامج المساعدdiscourse templates categories: الفئات المستخدمة لتخزين القوالب. سيتم استخدام كل عنوان في هذه الفئات وفئاتها الفرعية كقالب وسيكون متاحًا للمستخدمين الذين يمكنهم رؤيتها في فئاتها الأصلية.discourse templates enable private templates: تمكين استخدام القوالب الخاصة.discourse templates groups allowed private templates: مجموعات المستخدمين المسموح لهم باستخدام القوالب الخاصة.
يُسمح دائمًا لأعضاء الفريق.
discourse templates private templates tags: الوسوم التي سيتم استخدامها لوضع علامة على الرسائل الخاصة كقوالب.
كيفية الاستخدام
بعد تثبيت البرنامج المساعد، ستحتاج إلى إنشاء فئة واحدة على الأقل لتخزين القوالب.
ملاحظة: سيتمكن كل مستخدم لديه صلاحية قراءة العناوين في هذه الفئة من استخدام وظائف البرنامج المساعد في محرر النصوص.
Make new topics wikis by defaultفي إعدادات الفئة.
بعد ذلك، حدد الفئة في إعدادات البرنامج المساعد.
انتهى الأمر. الآن يتعين عليك فقط إنشاء بعض العناوين في الفئة المحددة وستكون متاحة للاستخدام كقوالب.
إذا أردت، يمكنك إنشاء فئات فرعية لتنظيم القوالب بشكل أفضل أو لتوفير مجموعات مختلفة من الردود لمجموعات متعددة من المستخدمين.
لإدراج القوالب، يجب عليك أولاً فتح محرر الرد والنقر فوق زر الإضافات، ثم اختيار خيار “إدراج قالب”
اختر القالب المطلوب، يمكنك البحث بالنص أو الوسوم وانقر على أيقونة “لصق”.
اختصار لوحة المفاتيح
يمكنك استخدام Ctrl+Shift+I على أجهزة الكمبيوتر أو ⌘+Shift+I على أجهزة Mac لإدراج القوالب.
القوالب الخاصة
تحتاج إلى تكوين الإعدادات التالية في إعدادات Discourse لتعمل:
tagging enabled: يجب تفعيلها.enable personal messages: يجب تفعيلها إذا كنت تريد جعل الميزة متاحة للمستخدمين غير الأعضاء في الفريق.pm tags allowed for groups: ستحتاج إلى السماح للمجموعات التي ستستخدم القوالب الخاصة بوضع علامة على الرسائل الخاصة.
لاستخدام القوالب الخاصة، يجب عليك أولاً تفعيلها في الإعدادات، وتعيين مجموعات المستخدمين الذين يمكنهم استخدامها، وتعيين وسوم واحد على الأقل لوضع علامة على الرسائل الخاصة كقالب.
لإنشاء قالب شخصي، يجب على المستخدمين:
- إرسال رسالة شخصية غير مشفرة إلى أنفسهم موسومة بأحد الوسوم المحددة في إعدادات البرنامج المساعد. فقط لمؤلف الرسالة سيظهر كقالب خاص.
المتغيرات المملوءة مسبقًا
يدعم البرنامج المساعد المتغيرات التالية في القوالب:
my_usernamemy_nametopic_titletopic_urloriginal_poster_usernameoriginal_poster_namereply_to_usernamereply_to_namelast_poster_usernamereply_to_or_last_poster_username.
جميع المتغيرات المذكورة أعلاه تدعم النص الاحتياطي وستقوم بإزالة المتغير إذا لم يتم تحديد احتياطي ولا يمكن استبدال المتغير.
يدعم كل من العنوان والجسم استبدال المتغيرات.
مثال:
مرحبًا %{reply_to_username,fallback:الجميع},
...
مع أطيب التحيات،
%{my_name}
إذا لم يكن reply_to_username متاحًا، سيكون القالب:
مرحبًا الجميع،
...
مع أطيب التحيات،
Arpit Jalan
الترحيل من discourse-canned-replies
هناك مهمة rake للترحيل الردود الجاهزة الموجودة إلى قوالب:
rake "discourse-templates:migrate-from-canned-replies"
استغرق هذا بضع ثوانٍ فقط للعمل على Meta لترحيل 47 ردًا جاهزًا، لذا يجب أن يكون آمنًا للاستخدام ما لم يكن لديك عدد هائل من الردود الجاهزة.
المهام المتبقية
توسيع الوظائف إلى أماكن أخرى غير محرر النصوص
السماح باستخدام أكثر من فئة رئيسية كمصادر للقوالب
سجل التغييرات
- 2022-07-14T03:00:00Z: تمت إضافة القدرة على استخدام عدة فئات رئيسية كمصدر للقوالب
- 2022-07-18T03:00:00Z: القوالب الخاصة
- 2022-08-10T03:00:00Z: اختصار لوحة مفاتيح عالمي