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

[lindsey (Lindsey Fogle)]

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

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

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

ملاحظة: بالنسبة للنماذج التي تعمل كإرشادات بدلاً من نموذج منظم، فكر في استخدام قوالب المواضيع (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: مصفوفة بالخيارات المتاحة

سمات محدد مجموعة العلامات (Tag Group selector attributes):

• tag_group: (خاصية حقل المستوى الأعلى) اسم مجموعة العلامات لاسترداد الخيارات منها
• none_label: النص المعروض عندما لا يتم تحديد أي خيار
• multiple: قيمة منطقية تشير إلى ما إذا كان يمكن للمستخدمين تحديد علامات متعددة (الإطار الأساسي الافتراضي يضبط هذا على true)

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

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

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

بعد إنشاء نموذج:

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

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

[Eingang]

كيف تبدو أنماط التعابير النمطية (regex) وما هي نكهة التعابير النمطية المتوقعة؟ لقد جربت ما يلي ونجحت جميعها، لكنني لم أتوقع ذلك:

• 2[6-9][0-1][0-9][0-3][0-9] مع إدخال 180918؛
• /2[6-9][0-1][0-9][0-3][0-9]/ مع إدخال 180918؛
• /2[6-9][0-1][0-9][0-3][0-9]/ مع إدخال 12؛