إنشاء قوالب نماذج

[lindsey (Lindsey Fogle)]

يشرح هذا الدليل كيفية استخدام قوالب النماذج (form templates) لتنظيم المحتوى في ديسكورس (Discourse).

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

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

ملاحظة: بالنسبة للقوالب التي تعمل كإرشادات بدلاً من نموذج منظم، فكر في استخدام قوالب المواضيع (topic templates).

تفعيل قوالب النماذج

يمكنك تشغيل قوالب النماذج في التغييرات القادمة (Upcoming changes) عن طريق تعيين تمكين قوالب النماذج (Enable form templates) على “الجميع (Everyone)”.

إنشاء قوالب النماذج

يمكنك إنشاء وإدارة قوالب النماذج بالانتقال إلى مسؤول (Admin) > المظهر (Appearance) > قوالب النماذج (Form templates) (/admin/customize/form-templates).

لإنشاء قالب نموذج:

1. انقر على نموذج جديد (New Template).

2. قم بتحديث حقل اسم القالب (Template Name) باسم داخلي لقالبك.

3. استخدم الأزرار الموجودة في الجزء العلوي من الصفحة لإضافة حقول مختلفة إلى نموذجك وتحديث سمات الحقل (مفصلة أدناه). العديد من الخيارات هي أنواع حقول نموذج قياسية (على سبيل المثال، مربع اختيار، إجابة قصيرة، قائمة منسدلة، إلخ)، ولكن هناك بعض الحقول المحددة:

   • محدد مجموعة الوسوم (Tag Group selector): يمكن للمستخدمين تحديد وسم واحد أو أكثر من مجموعة معينة.

   • إجابة ماركداون (Markdown answer): يمكن للمستخدمين إضافة محتوى مباشرة في نسخة مصغرة من المؤلف. هذا مثالي عندما يحتاج الأعضاء إلى إدخال ماركداون مباشرة، مثل الأكواد البرمجية، أو يحتاجون إلى تنسيق آخر يدعمه المحرر الغني.

4. أضف أي عمليات تحقق مرغوبة إلى مدخلاتك. انقر على زر التحقق (Validation) لمفتاح (معروض أيضًا أدناه).

5. انقر على زر معاينة (Preview) للتأكد من أن كل شيء يبدو صحيحًا.

6. انقر على زر حفظ (Save).

سمات الحقل

السمات الشائعة لجميع أنواع الحقول:

• label: اسم الحقل المرئي
• placeholder: نص المساعدة المعروض في الحقول الفارغة (إدخال، مساحة نصية، قائمة منسدلة، اختيار متعدد)
• description: سياق إضافي أو تعليمات معروضة أسفل الحقل.

السمات الخاصة بالتحميل (Upload-specific attributes):

• file_types: قائمة مفصولة بفواصل بامتدادات الملفات المسموح بها (على سبيل المثال، .jpg، .png، .pdf)
• allow_multiple: قيمة منطقية تشير إلى ما إذا كان يمكن للمستخدمين تحميل ملفات متعددة

سمات القائمة المنسدلة والاختيار المتعدد (Dropdown and multi-select attributes):

• none_label: النص المعروض عندما لا يتم تحديد أي خيار
• choices: مصفوفة بالخيارات المتاحة

خيارات التحقق

المفتاح (Key)	النوع (Type)	الوصف (Description)
required	منطقي (boolean)	يتطلب إكمال الحقل لتقديم النموذج.
minimum	عدد صحيح (integer)	بالنسبة للحقول النصية، يحدد الحد الأدنى لعدد الأحرف المسموح به.
maximum	عدد صحيح (integer)	بالنسبة للحقول النصية، يحدد الحد الأقصى لعدد الأحرف المسموح به.
pattern	تعبير عادي؛ سلسلة (regex; string)	بالنسبة للحقول النصية، تعبير عادي يحدد المدخلات المسموح بها.
type	سلسلة (string)	بالنسبة لحقول الإدخال، يمكنك تحديد نوع الإدخال المتوقع (text، email، date، number، url، tel، color

إضافة قوالب النماذج إلى فئة

بعد إنشاء قالب:

1. انتقل إلى الفئة التي تريد استخدام القالب فيها.
2. انقر على زر لتحرير الفئة.

3. قم بتبديل زر الإعدادات المتقدمة (Advanced settings) (إذا كنت تستخدم تصميم الفئة المبسط الجديد (simplified category design)).
4. انتقل إلى علامة التبويب القالب (Template).
5. قم بتشغيل تبديل قالب النموذج (Form template).
6. حدد قالب النموذج في القائمة المنسدلة.
7. انقر على حفظ الفئة (Save category).

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

تجربة العضو

إنشاء مواضيع باستخدام قوالب النماذج

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

ملء قيم النموذج مسبقًا

يمكن ملء حقول النموذج مسبقًا باستخدام معلمات URL تطابق معرفات الحقول. على سبيل المثال: /new-topic?software-version=2.4.1&severity=Critical

هذا مفيد للربط بإنشاء موضوع مع ملء حقول معينة بالفعل.