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

[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: اختصار لوحة مفاتيح عام.

[BryanV (Bryan Van de ven)]

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

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

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

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

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

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

[not-ethan (Ethan)]

يمكنك إنشاء موضوع في Feature مع الوسم templates

@saquetim

نظرًا لأن هذا مكون إضافي رسمي تحتفظ به فريق Discourse، يمكن تقديم طلبات Support و Bug و UX و 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”)