نماذج النقاشات

[Discourse]

|||
|—|—|—|
|:discourse2: | ملخص | تسمح قوالب Discourse بإنشاء قوالب محتوى للاستخدام المتكرر. يتم تخزين القوالب كمواضيع في فئة خاصة، حيث يمكن تعديلها ومناقشتها حسب الحاجة.|
|:open_book: | دليل التثبيت | هذه الإضافة مدمجة مع نواة Discourse. لا حاجة لتثبيت الإضافة بشكل منفصل.

نظرًا لأن هذه #إضافة_رسمية تتم صيانتها بواسطة فريق Discourse، يمكن تقديم طلبات #الدعم، #الأخطاء، #تجربة_المستخدم، و #الميزات في الفئات ذات الصلة هنا على Meta، ووضع علامة عليها باستخدام علامة الإضافة المناسبة. انقر على أحد الروابط أدناه لبدء أحدها.
الدعم (Discourse Meta “اطلب الدعم بشأن تكوين واستخدام قوالب Discourse”) خطأ (Discourse Meta “تقرير الخطأ يعني أن شيئًا ما معطل، مما يمنع الاستخدام الطبيعي/النموذجي للإضافة”) تجربة المستخدم (Discourse Meta “مناقشة حول واجهة المستخدم لقوالب Discourse، وكيفية عرض الميزات (بما في ذلك عناصر اللغة وواجهة المستخدم)”) ميزة (Discourse Meta “مناقشة حول كيفية تحسين أو تعزيز ميزات قوالب Discourse الحالية، وكيف يمكن أن تعمل الميزات الجديدة المقترحة”)

هذه الإضافة هي في الأساس نسخة جديدة من ردود canned Discourse ولكنها أكثر مرونة وتخزن القوالب بطريقة مختلفة.

الميزات

تستخدم هذه الإضافة فئة واحدة أو أكثر لتخزين القوالب للاستخدام لاحقًا. سيتم استخدام المنشور الأول في كل موضوع في هذه الفئات كقالب للردود.

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

سيتم استخدام المواضيع المرئية فقط كقوالب، لذلك لن يتم إدراج المواضيع غير المدرجة والمؤرشفة.

تستفيد الإضافة أيضًا من إعدادات أمان الفئات للتحقق من المستخدمين الذين يمكنهم استخدام القوالب. إذا كان بإمكان المستخدم قراءة المواضيع في الفئة، فسيكون خيار “إدراج قوالب” متاحًا في المنشئ للاستخدام. سيتمكن المستخدم فقط من رؤية القوالب/المواضيع في الفئات التي لديه وصول إليها.

يمكن استخدام فئات أصلية متعددة و/أو فئات فرعية لتوفير مجموعات مختلفة من القوالب ليتم استخدامها لمجموعات مختلفة من المستخدمين وتنظيم القوالب.

قوالب خاصة

تدعم الإضافة أيضًا القوالب الخاصة. القوالب الخاصة هي رسائل خاصة تم تمييزها كقوالب. ستكون هذه الرسائل متاحة كقوالب فقط لمؤلف الرسالة.

لن يتم إدراج الرسائل المؤرشفة كقوالب.

يمكنك العثور على جميع قوالبك الخاصة على:
/u/{اسم-المستخدم}/messages/tags/{علامة-القالب-الخاص}

الإعدادات:

• discourse templates enabled: تفعيل الإضافة.
• discourse templates categories: الفئات المستخدمة لتخزين القوالب. سيتم استخدام كل موضوع في هذه الفئات وفئاتها الفرعية كقالب وسيتاح للمستخدمين الذين يمكنهم رؤيتها في فئاتها الأصلية.
• discourse templates enable private templates: تمكين استخدام القوالب الخاصة.
• discourse templates groups allowed private templates: مجموعات المستخدمين المسموح لهم باستخدام القوالب الخاصة.

يُسمح دائمًا لأعضاء الطاقم.

• discourse templates private templates tags: العلامات التي سيتم استخدامها لتمييز الرسائل الخاصة كقوالب.

كيفية الاستخدام

بعد تثبيت الإضافة، ستحتاج إلى إنشاء فئة واحدة على الأقل لتخزين القوالب.

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

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

بعد ذلك، حدد الفئة في إعدادات الإضافة.

هذا كل شيء. الآن عليك فقط إنشاء بعض المواضيع في الفئة المحددة وستكون متاحة للاستخدام كقوالب.

إذا أردت، يمكنك إنشاء فئات فرعية لتنظيم القوالب بشكل أفضل أو لتوفير مجموعات مختلفة من الردود لمجموعات متعددة من المستخدمين.

لإدراج القوالب، يجب عليك أولاً فتح منشئ الرد والنقر على زر الإضافات، ثم تحديد خيار “إدراج قالب”.

حدد القالب المطلوب، يمكنك البحث عن طريق النص أو العلامات والنقر على أيقونة “لصق”.

اختصار لوحة المفاتيح
يمكنك استخدام Ctrl+Shift+I على أجهزة الكمبيوتر الشخصية أو ⌘+Shift+I على أجهزة Mac لإدراج القوالب.

سيعمل اختصار لوحة المفاتيح داخل أي مربع نص في Discourse.

قوالب خاصة

ستعمل القوالب الخاصة فقط في المثيلات التي تم فيها تمكين كل من الرسائل الخاصة والعلامات.

تحتاج إلى تكوين إعدادات Discourse التالية لكي تعمل:

• يجب تمكين tagging enabled.
• يجب تمكين enable personal messages إذا كنت تريد جعل الميزة متاحة للمستخدمين غير الموظفين.
• ستحتاج إلى السماح للمجموعات التي ستستخدم القوالب الخاصة بتمييز الرسائل الخاصة.

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

لإنشاء قالب شخصي، يجب على المستخدمين:

• إرسال رسالة شخصية غير مشفرة إلى أنفسهم مميزة بإحدى العلامات المكونة في إعدادات الإضافة. سيتمكن مؤلف الرسالة فقط من رؤيتها كقالب خاص.

يمكن أيضًا تمييز الرسائل الخاصة المرسلة إلى مستخدمين آخرين، ولكن مؤلف الرسالة فقط سيكون قادرًا على استخدامه كقالب.

متغيرات مملوءة مسبقًا

تدعم الإضافة المتغيرات التالية في القوالب:

• my_username
• my_name
• topic_title
• topic_url
• original_poster_username
• original_poster_name
• reply_to_username
• reply_to_name
• last_poster_username
• reply_to_or_last_poster_username.

تدعم جميع المتغيرات المذكورة أعلاه نصًا احتياطيًا وستقوم بإزالة المتغير إذا لم يتم تحديد نص احتياطي ولم يتمكن المتغير من الاستبدال.

يدعم كل من العنوان والنص استبدال المتغيرات.

مثال:

Hi %{reply_to_username,fallback:there},

...

Regards,
%{my_name}

إذا لم يكن reply_to_username متاحًا، فسيكون القالب:

Hi there,

...

Regards,
Arpit Jalan

---

الترحيل من discourse-canned-replies

هناك مهمة rake لترحيل الردود canned الموجودة إلى قوالب:

rake "discourse-templates:migrate-from-canned-replies"

استغرقت هذه المهمة بضع ثوانٍ فقط لتشغيلها على Meta لترحيل 47 ردًا canned، لذا يجب أن تكون آمنة للاستخدام ما لم يكن لديك عدد هائل من الردود canned.

TODO

• توسيع الوظائف إلى أماكن أخرى بخلاف المنشئ
• السماح باستخدام أكثر من فئة أصل واحدة كمصادر للقوالب

سجل التغييرات

• 2022-07-14T03:00:00Z: تمت إضافة القدرة على استخدام فئات أصل متعددة كمصدر للقوالب.
• 2022-07-18T03:00:00Z: قوالب خاصة.
• 2022-08-10T03:00:00Z: اختصار لوحة مفاتيح عام.