الامتداد "Survey"

This page is a translated version of the page Extension:Survey and the translation is 100% complete.
This extension is professionally maintained by the WikiTeq team.
WikiTeq provides official support for MediaWiki LTS releases only. It may work with other MediaWiki releases.
الدليل المرجعي لامتدادات ميدياويكي
Survey
حالة الإصدار تجريبي
تنفيذ صفحة خاصة , واجهة برمجة التطبيقات , واجهة مستخدم, أجاكس
بيان الامتداد "Survey" هو امتداد لميدياويكي يسمح للمسؤولين بتعريف استطلاعات يمكن عرضها لمجموعات معينة من المستخدمين.
المؤلف/المؤلفون Jeroen De Dauw
القائم/القائمون بالصيانة WikiTeq team
آخر إصدار 0.3.0 alpha (2014-04-02)
سياسة التوافق لكل إصدار ميديايويكي يكون إصدار دعم طويل الأجل يوجد فرع مخصص له في الامتداد.
MediaWiki 1.39
PHP 7.0+
تغييرات قاعدة البيانات نعم
ترخيص رخصة جنو العمومية 2.0 أو ما بعدها
التنزيل
README
  • $wgSurveySettings
  • surveyadmin
  • surveysubmit
تنزيلات ربع سنوية 3 (Ranked 129th)
ترجم الامتداد Survey لو كان متوفرا على translatewiki.net
المسائل المهام المفتوحة · الإبلاغ عن عطل تقني

الامتداد "Survey" يسمح للمسؤولين بتعريف استطلاعات يمكن عرضها لمجموعات محددة من المستخدمين. للأسف، هذا الامتداد غير متوافق مع أي إصدار مدعوم حاليًا من ميدياويكي.

نظرة عامة على الميزات

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

التثبيت

  • نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎Survey داخل مجلد ‎extensions/‎ لديك.
    يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Survey
  • أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :
    wfLoadExtension( 'Survey' );
    
  • شغل نص التحديث البرمجي الذي سوف ينشئ تلقائيا جداول قاعدة البيانات الضرورية التي يحتاج إليها الامتداد.
  • قم بالتكوين كما هو مطلوب.
  •   تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.


التكوين

يتم تكوين المسح عن طريق تعيين $egSurveySettings في ملف LocalSettings.php الخاص بك. الخيارات مُدرجة أدناه، وتم تعيين قيمها الافتراضية في ملف إعدادات الاستبيان.

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

مثال لكيفية تغيير الإعداد:

$egSurveySettings['defaultEnabled'] = true;

الإعدادات المتاحة:

الاسم النوع افتراضي وصف
defaultEnabled boolean false إذا كان ينبغي تمكين الاستطلاعات بشكل افتراضي
defaultUserType Survey::$USER_ Survey::$USER_ALL النوع الافتراضي للمستخدمين الذي يظهر لهم الاستطلاع
defaultNamespaces array array() مساحات الأسماء الافتراضية التي يجب أن تظهر فيها الاستطلاعات. قائمة فارغة لعدم وجود قيود على مساحة الاسم
defaultRatio integer 100 النسبة المئوية الافتراضية للمستخدمين التي يجب أن تظهر لهم الاستطلاعات
defaultExpiry integer 60 * 60 * 24 * 30 انتهاء الصلاحية الافتراضي لملفات تعريف الارتباط المستخدمة لتتبع استكمال استطلاع المستخدمين، بالثواني
defaultMinPages integer 0 الحد الأدنى الافتراضي لعدد الصفحات التي يجب على المستخدمين زيارتها قبل الحصول على استطلاع
JSDebug boolean false يشير إلى ما إذا كان يجب تشغيل تصحيح أخطاء JavaScript أم لا. يجب أن تكون خاطئة في بيئات الإنتاج.

الاستخدام

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

إنشاء وتحرير الاستطلاعات

يمكن إنشاء الاستطلاعات وتحريرها وإزالتها في Special:Surveys بواسطة أشخاص يتمتعون بحق مسؤول الاستطلاع، وبشكل افتراضي فقط sysops.

استطلاعات الاختبار

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

نشر الاستطلاعات

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

إذا كنت تريد بدلاً من ذلك نشر استطلاع على صفحة فردية واحدة أو أكثر، فيمكنك تضمين علامة استطلاع $ في كل صفحة. يتم استدعاؤه بالطريقة التالية:

<survey id="" ratio="" expiry="" min-pages="" />

يجب أن يتطابق المعرف مع معرف الاستطلاع، وهو السلسلة التي تظهر بعد "Special:TakeSurvey/". تتوافق السمات الأخرى مع الإعدادات الموجودة في Special:EditSurvey.

لاحظ أن استخدام علامة الاستطلاع هي ميزة تجريبية قد لا تعمل بشكل صحيح في جميع المواقف.

تتبع الاستطلاعات

يمكن العثور على ملخص لنتائج الاستطلاع على Special:SurveyStats، المرتبط بواجهة المستخدم الإدارية. لا يمكن الوصول إلى هذا إلا من قبل الأشخاص الذين لديهم حق مسؤول الاستطلاع.

تصدير البيانات عبر واجهة برمجة التطبيقات

يسمح لك المسح بتصدير الاستطلاعات وبيانات الإرسال عبر MediaWiki API باستخدام وحدات واجهة برمجة التطبيقات الثلاث التالية:

  • ApiQuerySurveys — احصل على الاستبيانات المطابقة للشروط المقدمة — api.php?action=query&list=surveys&suids=4|2
  • ApiQuerySurveySubmissions — احصل على المشاركات الخاصة بالاستبيان — رمز $
  • ApiQuerySurveyAnswers — احصل على الإجابات (هناك 1 لكل حقل في الإرسال) — api.php?action=query&list=surveyanswers&qaid=42

لا يمكن استخدام هذه الوحدات إلا للاستعلام عن البيانات بواسطة الأشخاص الذين لديهم حق مسؤول الاستطلاع. يمكن العثور على الوثائق الكاملة لوحدات API هذه على api.php على الويكي الخاص بك.

الإصدار

الإصدار 0.3.0 ألفا هو محاولة لجعل هذا الامتداد متوافقًا مع MediaWiki 1.23+.

تغطي ملاحظات الإصدار في Git ما يصل إلى الإصدار 2.0 فقط في هذه المرحلة.

التدويل

تم تدويل المسح بالكامل. تتم ترجمة رسائل الاستطلاع من خلال translatewiki.net. يمكن العثور على ترجمة هذا الامتداد هنا. لإضافة قيم لغة أو تغيير القيم الموجودة، يجب عليك إنشاء حساب على Translationwiki.net، ثم طلب الإذن من المسؤولين لترجمة لغة أو لغات معينة على هذه الصفحة (هذه طريقة سهلة الاستخدام عملية بسيطة). بمجرد حصولك على إذن للغة معينة، يمكنك تسجيل الدخول وإضافة أو تعديل أي رسائل تريدها بتلك اللغة.

المؤلفون

تمت كتابة الاستبيان بواسطة Jeroen De Dauw بصفته مستشار WikiWorks لـ the IEEE.

لقطات

أنظر أيضاً