||||\n-|-|-|\n:discourse2: | الملخص | يتيح لك المكون الإضافي Discourse Surveys إنشاء استطلاعات رأي مباشرة داخل منشورات منتدى Discourse الخاص بك باستخدام صيغة Markdown بسيطة.\n:hammer_and_wrench: | رابط المستودع | \u003chttps://github.com/discourse/discourse-surveys\u003e\n:open_book: | دليل التثبيت | كيفية تثبيت المكونات الإضافية في Discourse\n\nيتيح لك المكون الإضافي Discourse Surveys إنشاء استطلاعات رأي مباشرة داخل منشورات منتدى Discourse الخاص بك باستخدام صيغة Markdown بسيطة. يدعم المكون الإضافي حاليًا مجموعة متنوعة من أنواع الأسئلة مثل الأزرار الإذاعية (radio buttons)، ومربعات الاختيار (checkboxes)، والقوائم المنسدلة (dropdowns)، ومدخلات الأرقام (number inputs)، ومناطق النص (text areas)، وتقييمات النجوم (star ratings)، وتقييمات الإعجاب/عدم الإعجاب (thumbs up/down ratings).\n\n## الميزات\n\n- 7 أنواع حقول مختلفة: أزرار راديو، مربعات اختيار، قوائم منسدلة، مناطق نص، اختيار أرقام، تقييمات نجوم، وتقييمات إعجاب/عدم إعجاب\n\n- حقول مطلوبة/اختيارية: ضع علامة على الحقول كمطلوبة لضمان الإكمال\n\n- دعم الرموز التعبيرية (Emoji Support): استخدم الرموز التعبيرية في خيارات الاستطلاع الخاصة بك\n\n- دعم HTML: تنسيق نص غني في الأسئلة والخيارات\n\n- مصادقة المستخدم: مطالبات تسجيل دخول تلقائية للمستخدمين المجهولين\n\n- تتبع الاستجابات: يمنع الإرسالات المكررة من نفس المستخدم\n\n- مراعاة الأذونات: يحترم أذونات الموضوع والفئة\n\n- متجاوب مع الجوال: يعمل بسلاسة على جميع الأجهزة\n\n## الاستخدام\n\n### هيكل الاستطلاع الأساسي\n\nيجب أن تكون جميع الاستطلاعات مغلفة بعلامات [survey]:\n\nmarkdown\n\n[survey name=\"my-survey\" title=\"استبيان ملاحظات العملاء\"]\n\n<!-- تذهب حقول الاستطلاع هنا -->\n\n[/survey]\n\n\n\n### سمات الاستطلاع\n\n- name: مُعرّف فريد للاستطلاع (الافتراضي هو "survey")\n\n- title: عنوان اختياري يُعرض في أعلى الاستطلاع\n\n- public: تعيين الرؤية (ميزة مستقبلية)\n\n- status: حالة الاستطلاع (ميزة مستقبلية)\n\n### أنواع الحقول\n\n#### 1. الأزرار الإذاعية (اختيار واحد)\n\nmarkdown\n\n[radio question=\"ما هو لونك المفضل؟\"]\n\n- أحمر\n\n- أزرق\n\n- أخضر\n\n- أصفر\n\n[/radio]\n\n\n\n#### 2. مربعات الاختيار (اختيار متعدد)\n\nmarkdown\n\n[checkbox question=\"ما هي الميزات التي تستخدمها؟ (حدد كل ما ينطبق)\"]\n\n- إشعارات البريد الإلكتروني\n\n- تطبيق الجوال\n\n- إشعارات سطح المكتب\n\n- الوصول إلى واجهة برمجة التطبيقات (API)\n\n[/checkbox]\n\n\n\n#### 3. اختيار القائمة المنسدلة\n\nmarkdown\n\n[dropdown question=\"ما هي فئتك العمرية؟\"]\n\n- أقل من 18\n\n- 18-24\n\n- 25-34\n\n- 35-44\n\n- 45-54\n\n- 55+\n\n[/dropdown]\n\n\n\n#### 4. منطقة النص (نص طويل)\n\nmarkdown\n\n[textarea question=\"يرجى تقديم ملاحظات مفصلة:\" required=\"false\"]\n\n[/textarea]\n\n\n\n#### 5. اختيار الرقم\n\nmarkdown\n\n[number question=\"قيّم هذه الميزة من 1-10:\" min=\"1\" max=\"10\"]\n\n[/number]\n\n\n\n#### 6. تقييم النجوم\n\nmarkdown\n\n[star question=\"كيف تقيّم تجربتك الإجمالية؟\"]\n\n[/star]\n\n\n\n#### 7. إعجاب/عدم إعجاب\n\nmarkdown\n\n[thumbs question=\"هل ستوصي بهذا للآخرين؟\"]\n\n[/thumbs]\n\n\n\n### سمات الحقل\n\nجميع أنواع الحقول تدعم هذه السمات:\n\n- question: نص السؤال (مطلوب)\n\n- required: ما إذا كان يجب ملء الحقل (true/false، الافتراضي هو true)\n\n- min: الحد الأدنى للقيمة لحقول الأرقام\n\n- max: الحد الأقصى للقيمة لحقول الأرقام\n\n### مثال كامل\n\n### صيغة Markdown الأساسية للاستطلاع\n\nإليك مثال أساسي لصيغة Markdown للاستطلاع يتضمن جميع الحقول المتاحة:\n\n\n[survey name=\"awesome-survey-thumbs\" title=\"استطلاع رائع\"]\n\n[radio question=\"اختر أي خيار واحد:\"]\n- قط\n- كلب\n[/radio]\n\n[checkbox question=\"اختر خيارات متعددة:\"]\n- أحمر\n- أزرق\n- أخضر\n[/checkbox]\n\n[dropdown question=\"الجنس:\"]\n- ذكر\n- أنثى\n[/dropdown]\n\n[number question=\"قيّم هذا الاستطلاع من 1 إلى 10:\"]\n[/number]\n\n[textarea question=\"ما هي ملاحظاتك حول س ص ع؟\" required=\"false\"]\n[/textarea]\n\n[star question=\"كيف تقيّم التجربة الإجمالية؟\"]\n[/star]\n\n[thumbs question=\"هل كنت راضيًا عن خدماتنا؟\"]\n[/thumbs]\n\n[/survey]\n\n\n### عرض الاستطلاع\n\nأدناه مثال لكيفية عرض صيغة Markdown المذكورة أعلاه في Discourse:\n\n
markdown\n\n[radio question=\"اختر حيوانك المفضل:\"]\n\n- 🐈 قطة\n\n- 🐶 كلب\n\n- 🐦 طائر\n\n- 🐠 سمكة\n\n[/radio]\n\n\n\n### تنسيق HTML في الأسئلة\n\nmarkdown\n\n[radio question=\"ما هي \u003cstrong\u003elغة البرمجة\u003c/strong\u003e التي تفضلها؟\"]\n\n- JavaScript\n\n- Python\n\n- Ruby\n\n- Go\n\n[/radio]\n\n\n\n### حقول مختلطة مطلوبة واختيارية\n\nmarkdown\n\n[survey name=\"mixed-survey\"]\n\n[radio question=\"ما هو دورك؟\" required=\"true\"]\n\n- مطور\n\n- مصمم\n\n- مدير\n\n- آخر\n\n[/radio]\n\n[textarea question=\"أي أفكار إضافية؟\" required=\"false\"]\n\n[/textarea]\n\n[/survey]\n\n\n\n## نتائج الاستطلاع\n\nحاليًا، لا يحتوي هذا المكون الإضافي على واجهة مستخدم خلفية لعرض نتائج الاستطلاع مباشرة. بدلاً من ذلك، يمكنك الاعتماد على استعلامات مستكشف البيانات (Data Explorer) لجلب وتحليل استجابات الاستطلاع. إليك مثال على استعلام:\n\nsql\n-- [params]\n-- text :survey_name = survey\n\nSELECT 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\nFROM surveys s\nJOIN survey_fields sf ON sf.survey_id = s.id\nJOIN survey_responses sr ON sr.survey_field_id = sf.id\nLEFT JOIN survey_field_options sfo ON sfo.id = sr.survey_field_option_id\nWHERE s.name = :survey_name\nORDER BY s.id DESC\n\n\n## الأذونات والأمان\n\n- تسجيل الدخول مطلوب: يجب على المستخدمين المجهولين تسجيل الدخول قبل إرسال الردود\n\n- استجابة واحدة لكل مستخدم: يمكن لكل مستخدم إرسال استجابة واحدة فقط لكل استطلاع\n\n- أذونات الموضوع: يجب أن يكون لدى المستخدمين إذن قراءة للموضوع لعرض الاستطلاعات\n\n- أذونات النشر: يجب أن يكون لدى المستخدمين إذن نشر في الموضوع لإرسال الردود\n\n- المواضيع المؤرشفة: لا يمكن للاستطلاعات في المواضيع المؤرشفة قبول ردود جديدة\n\n- المنشورات المحذوفة: لم يعد من الممكن الوصول إلى الاستطلاعات في المنشورات المحذوفة\n\n## القيود\n\n- يُسمح باستطلاع واحد فقط لكل منشور\n\n- لا يمكن تعديل هيكل الاستطلاع بعد تلقي الردود\n\n- يجب أن تكون جميع أسئلة حقول الاستطلاع فريدة داخل استطلاع واحد\n\n- لا يمكن أن تكون أسئلة حقول الاستطلاع فارغة\n\n## التفاصيل التقنية\n\n### مخطط قاعدة البيانات\n\nينشئ المكون الإضافي أربعة جداول رئيسية لقاعدة البيانات:\n\n- surveys: سجلات الاستطلاع الرئيسية\n\n- survey_fields: الحقول الفردية داخل الاستطلاعات\n\n- survey_field_options: خيارات للحقول القائمة على الاختيار\n\n- survey_responses: استجابات المستخدمين لحقول الاستطلاع\n\n### التصميم (Styling)\n\nيتضمن المكون الإضافي أوراق أنماط CSS متجاوبة تتكيف مع السمة الخاصة بك. يمكن إضافة تصميم مخصص عن طريق استهداف فئات CSS هذه:\n\n- .survey - حاوية الاستطلاع الرئيسية\n\n- .survey-field - غلاف الحقل الفردي\n\n- .field-[type] - حاويات أنواع الحقول المحددة\n\n- .submit-response - زر الإرسال"