امتداد:AJAXPoll

الدليل المرجعي لامتدادات ميدياويكي

AJAXPoll حالة الإصدار مستقر
تنفيذ	امتداد المحلل اللغوي
بيان	يسمح باستطلاعات رأي تستند إلى لغة أجاكس باستخدام الوسم ‎<poll>
المؤلف/المؤلفون	Dariusz Siedlecki Jack Phoenix Thomas Gries
آخر إصدار	2.3.0 (2020-02-24)
MediaWiki	1.39.10+
جداول	ajaxpoll_info ajaxpoll_vote
ترخيص	رخصة جنو للوثائق الحرة
التنزيل	تنزيل الامتداد غت [?]: تنزيل ملف غت الرئيسي تصفح المستودع (Phabricator · GitHub) تاريخ الالتزام مساهمو المستودع (غت هب) مراجعة الكود البرمجي
مثال	Any ShoutWiki site
المتغيرات $wgAjaxExportList $wgTrackingCategories
تنزيلات ربع سنوية	22 (Ranked 118th)
ترجم الامتداد AJAXPoll لو كان متوفرا على translatewiki.net
المسائل	المهام المفتوحة · الإبلاغ عن عطل تقني

يسمح امتداد AJAXPoll بإضافة استطلاعات رأي تستند إلى لغة أجاكس على صفحات ميدياويكي باستخدام الوسم ‎<poll>.

التثبيت

• نزّل الملف/الملفات وضعها في دليل يحمل اسم ‎AJAXPoll داخل مجلد ‎extensions/‎ لديك.
  يجب على مطوري البرمجيات والمساهمين بالكود البرمجي تثبيت الامتداد من غت بدلا من ذلك، مستخدمين:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/AJAXPoll
• أضف الكود التالي في الجزء الأسفل من ملف LocalSettings.php :

  wfLoadExtension( 'AJAXPoll' );
  

• شغل نص التحديث البرمجي الذي سوف ينشئ تلقائيا جداول قاعدة البيانات الضرورية التي يحتاج إليها الامتداد. أعده حسب ما تريد.
•  تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

الإعداد

# if you want to restrict the poll
# use the following code lines after calling the AJAXPoll extension
# to restrict to user group (example)

# The 'ajaxpoll-view-results-before-vote' group permission allows the specified
# group members to view poll results even without having voted
# but only if the high-level group permission 'ajaxpoll-vote' allows to view
# results in general.
#
# This 'ajaxpoll-view-results-before-vote' can be overwritten with the specific
# per-poll setting "show-results-before-voting" which takes precedence over the
# group permission.
#
# permission 'ajaxpoll-view-results' >>
# >> per-poll setting "show-results-before-voting" (if present)
# >> permission 'ajaxpoll-view-results-before-vote'

# anons
# default: anons cannot vote and will never see results
$wgGroupPermissions['*']['ajaxpoll-vote'] = false;
$wgGroupPermissions['*']['ajaxpoll-view-results'] = false;
$wgGroupPermissions['*']['ajaxpoll-view-results-before-vote'] = false;

# users
# default: users can vote and can see poll results - when they have voted
$wgGroupPermissions['user']['ajaxpoll-vote'] = true;
$wgGroupPermissions['user']['ajaxpoll-view-results'] = true;

لو كنت تريد تعطيل تصنيف المتابعة الآلي عليك أن تغير نص رسالة النظام «MediaWiki:Ajaxpoll-tracking-category» على موقعك الويكي إلى «-» (سالب).

الاستخدام

البنية النحوية

<poll>
Question
Choice 1
Choice 2
Choice 3
Choice 4
</poll>

مثال

<poll>
Do you like this poll ?
Yes, it is awesome.
Yes.
No, I do not like polls.
I have no idea, what this means.
</poll>

إن كنت تريد ذلك، يمكنك السماح أو رفض عرض النتائج قبل التصويت لكل استطلاع رأي عن طريق إضافة المتغير show-results-before-voting إلى الوسم الافتتاحي:

<poll show-results-before-voting>
<poll show-results-before-voting=1>
<poll show-results-before-voting=0>

لو كان السطر الأول بعد ‎<poll> هو «STATS»، من ثم سوف تعرض بعض الإحصاءات عن موقع الويكي واستطلاعه للرأي. هذه الاستطلاعات لا يمكن أقلمتها كما أن هذه السمة كاملة قد ترفع (أو يعاد تنظيمها على الأقل، إلا أنها قد ترفع) في المستقبل.