الامتداد "Survey"

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 أو ما بعدها
التنزيل	تنزيل الامتداد غت [?]: تنزيل ملف غت الرئيسي تصفح المستودع (Phabricator · GitHub) تاريخ الالتزام مساهمو المستودع (غت هب) مراجعة الكود البرمجي README
المتغيرات $wgSurveySettings
صلاحيات مضافة surveyadmin surveysubmit
الروابط المستخدمة LoadExtensionSchemaUpdates UnitTestsList ParserFirstCallInit ArticleViewHeader AdminLinks
تنزيلات ربع سنوية	3 (Ranked 137th)
ترجم الامتداد 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.

لقطات

• 
  خاص: المسوحات التي تسرد المسوحات المتاحة
• 
  Special:EditSurvey هي واجهة تحرير الاستطلاعات
• 
  يتم عرض الاستطلاعات للمستخدمين كشاشة منبثقة، ويمكن اختبارها على Special:TakeSurvey
• 
  يمكن العثور على ملخصات طلبات الاستبيان على Special:SurveyStats