|||
-|-|-|
| ملخص | يتيح لك المكون الإضافي Discourse Surveys إنشاء استطلاعات رأي مباشرة داخل منشورات منتداك Discourse باستخدام صيغة Markdown بسيطة.
| رابط المستودع | https://github.com/discourse/discourse-surveys
| دليل التثبيت | كيفية تثبيت المكونات الإضافية في Discourse
يتيح لك المكون الإضافي Discourse Surveys إنشاء استطلاعات رأي مباشرة داخل منشورات منتداك Discourse باستخدام صيغة Markdown بسيطة. يدعم المكون الإضافي حاليًا مجموعة متنوعة من أنواع الأسئلة مثل الأزرار الراديو، وصناديق الاختيار، والقوائم المنسدلة، ومدخلات الأرقام، ومناطق النص، وتقييمات النجوم، وتقييمات الإعجاب/عدم الإعجاب.
صيغة Markdown الأساسية للاستطلاع
إليك مثال أساسي لصيغة Markdown للاستطلاع يتضمن جميع الحقول المتاحة:
[survey name="awesome-survey-thumbs" title="Awesome Survey"]
[radio question="Choose any one option:"]
- cat
- dog
[/radio]
[checkbox question="Choose multiple options:"]
- red
- blue
- green
[/checkbox]
[dropdown question="Gender:"]
- Male
- Female
[/dropdown]
[number question="Rate this survey from 1 to 10:"]
[/number]
[textarea question="What is your feedback about xyz?" required="false"]
[/textarea]
[star question="How would you rate overall experience?"]
[/star]
[thumbs question="Were you satisfied with our services?"]
[/thumbs]
[/survey]
عرض الاستطلاع
فيما يلي مثال لكيفية عرض صيغة Markdown أعلاه في Discourse:
نتائج الاستطلاع
حاليًا، لا يحتوي هذا المكون الإضافي على أي واجهة مستخدم خلفية لعرض نتائج الاستطلاع مباشرة. بدلاً من ذلك، يمكنك الاعتماد على استعلامات Data Explorer لجلب وتحليل استجابات الاستطلاع. إليك مثال للاستعلام:
-- [params]
-- text :survey_name = survey
SELECT s.id, s.name, s.post_id, sf.question, COALESCE(sr.value, sfo.html) AS value, sr.user_id, sr.created_at as responded_at
FROM surveys s
JOIN survey_fields sf ON sf.survey_id = s.id
JOIN survey_responses sr ON sr.survey_field_id = sf.id
LEFT JOIN survey_field_options sfo ON sfo.id = sr.survey_field_option_id
WHERE s.name = :survey_name
ORDER BY s.id DESC
النطاق المستقبلي
يتمتع المكون الإضافي بإمكانيات للعديد من التحسينات. لا تتردد في الانضمام إلى المناقشة، وتقديم طلبات السحب على مستودع المكون الإضافي.