قوالب النقاش

[Discourse]

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

نظرًا لأن هذا #برنامج_مساعد_رسمي يتم صيانته بواسطة فريق Discourse، يمكن تقديم طلبات #الدعم، #المساهمة:أخطاء، #المساهمة:تجربة_المستخدم، و #المساهمة:ميزات في الفئات ذات الصلة هنا على Meta، مع وسمها بالعلامة المناسبة للبرنامج المساعد. انقر على أحد الروابط أدناه لبدء واحدة.

 الدعم  خطأ  تجربة المستخدم  ميزة

هذا البرنامج المساعد هو إلى حد كبير نسخة جديدة من 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: العلامات التي سيتم استخدامها لوسم الرسائل الخاصة كقوالب.

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

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

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

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

بعد ذلك، حدد الفئة في إعدادات البرنامج المساعد.

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

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

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

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

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

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

القوالب الخاصة

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

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

• tagging enabled: يجب أن تكون مفعّلة.
• enable personal messages: يجب أن تكون مفعّلة إذا كنت تريد إتاحة الميزة للمستخدمين غير أعضاء الفريق.
• pm tags allowed for groups: ستحتاج إلى السماح للمجموعات التي ستستخدم القوالب الخاصة بوسم الرسائل الخاصة.

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

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

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

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

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

يدعم البرنامج المساعد المتغيرات التالية في القوالب:

• 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.

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

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

مثال:

مرحبًا %{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: اختصار لوحة المفاتيح العالمي

[BryanV (Bryan Van de ven)]

أين المكان المناسب لطلب ميزة؟ أرى أن متتبع المشكلات الخاص بمستودع GH المرتبط معطل. أود القدرة على لصق الردود “ضمن السطر” أي في منتصف جملة. لقد طلبت ذلك بالنسبة للمكون الإضافي الآخر السابق، وكان هناك بعض المناقشات (إيجابية على ما يبدو) حوله، لكنني لم أتمكن من تحديد موقعه.

أنا أحتاج كثيرًا إلى صياغة ردود تحتوي على، على سبيل المثال، مشكلة GitHub في منتصف جملة:

• إذا كنت ترغب في طلب [شيء] كميزة جديدة، يرجى فتح مشكلة GitHub
• [الميزة] موثقة بشكل غير كافٍ، وستكون مشكلة GitHub مناسبة لزيادة الرؤية.
• يبدو أن [سلوكًا ما] خطأ، يرجى فتح مشكلة GitHub مع التفاصيل الكاملة.

لدي الكثير من هذه المقتطفات، وأستخدمها باستمرار في منتدى دعم المستخدمين لدينا.

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

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

[not-ethan (Ethan)]

يمكنك إنشاء موضوع في Contribute > Feature باستخدام الوسم templates

@saquetim

نظرًا لأن هذا official plugin يحافظ عليه فريق Discourse، يمكن تقديم طلبات #support، و#contribute:bug، و#contribute:ux، و#contribute:feature في الفئات ذات الصلة هنا في Meta، مع وسمها بالوسم المناسب للبرنامج المساعد. انقر على أحد الروابط أدناه لبدء موضوع جديد.

دعم خطأ تجربة المستخدم ميزة

[david (David Taylor)]

هذه الإضافة مضمنة الآن مع Discourse الأساسي كجزء من Bundling more popular plugins with Discourse core. إذا كنت تستضيف بنفسك وتستخدم الإضافة، فأنت بحاجة إلى إزالتها من ملف app.yml الخاص بك قبل الترقية التالية.

[Paul_King]

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

[HAWK]

هل ترسل وتستقبل الردود عبر ديسكورس؟

[Moin]

يمكنك استخدام القوالب في العديد من حقول الإدخال حيث لا يظهر شريط الأدوات باستخدام اختصار لوحة المفاتيح ctrl + shift + i

[Paul_King]

نعم، يتم الإرسال عبر حقل “لماذا ترفض هذا المستخدم” عند حذف المستخدم الذي لم تتم الموافقة عليه.

[Paul_King]

هذا جيد!
بل أفضل من الحاجة إلى تذكر اختصار لوحة مفاتيح (والذي في حالتي سيتم استخدامه مرة واحدة شهريًا وبالتالي نسيانه) سيكون هناك زر صغير مرتبط بكل حقل فارغ، لتشغيل مربع الحوار الفرعي للقوالب.

[Moin]

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

عادةً ما أستخدم اختصار لوحة المفاتيح للمساعدة في الشريط الجانبي أو أضغط على \u003ckbd\u003e?\u003c/kbd\u003e لمعرفة أنه “i”. (حاولت أن أتذكر “إدراج قالب” “insert template”، لكن ذلك لم ينجح معي بشكل جيد، لأنني لم أتمكن من العثور على صياغة ألمانية تبدأ بحرف “i”)

[jordanjay29]

هل من الممكن الوصول إلى هذه القوالب في مُنشئ جديد عبر رابط؟ مثل التوافق مع https://meta.discourse.org/t/creating-a-link-to-start-a-new-topic-with-pre-filled-information/28074؟