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

ApiFeatureUsage حالة الإصدار مستقرCategory:Stable extensions/ar
تنفيذ	صفحة خاصة Category:Special page extensions/ar, واجهة برمجة التطبيقات Category:API extensions/ar
بيان	الوصول إلى موجز سجل استخدام سمة واجهة برمجة التطبيقات
المؤلف/المؤلفون	Brad Jorsch (Anomieنقاش)
آخر إصدار	1.0 (2016-12-07)
سياسة التوافق	تصدر اللقطات البرمجية مع ميدياويكي. الإصدار الرئيسي لا يتوافق مع الإصدارات السابقة.
MediaWiki	1.25+Category:Extensions with manual MediaWiki version
PHP	5.5.9+
تغييرات قاعدة البيانات	لا
ترخيص	رخصة جنو العمومية 2.0 أو ما بعدها
التنزيل	تنزيل الامتداد غت [?]: تصفح المستودع (GitHub) مراجعة الكود البرمجي على غيريت تاريخ الالتزام على غت تنزيل المصدر في صيغة تاربول Category:Extensions in Wikimedia version control/ar
المتغيرات $wgApiFeatureUsageQueryEngineConf
الروابط المستخدمة ApiDeprecationHelp Category:ApiDeprecationHelp extensions/ar ApiLogFeatureUsage Category:ApiLogFeatureUsage extensions/ar LoadExtensionSchemaUpdates Category:LoadExtensionSchemaUpdates extensions/ar
تنزيلات ربع سنوية	3 (Ranked 98th)
استخدام مواقع الويكي العمومية	847 (Ranked 302nd)
ترجم الامتداد ApiFeatureUsage
المسائل	المهام المفتوحة · الإبلاغ عن عطل تقني

يضيف امتداد ApiFeatureUsage صفحة خاصة ووحدة واجهة برمجة تطبيقات تستخدم في استحضار موجزات للبيانات التي يسجلها ApiBase::logFeatureUsage()، الذي يشير في العادة إلى استخدام ميزات واجهة برمجية تطبيقات متقادمة.

أمور تابعة

يتعين أن تضاف بيانات السجل إلى أحد أنواع أنظمة الحفظ. يدعم Extension:Elastica في الوقت الراهن Elasticsearch.

التنصيب

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

  wfLoadExtension( 'ApiFeatureUsage' );
  

• تم التنفيذ – اذهب إلى Special:Version على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

الإعداد

المتغيرات

Elastica backend (ApiFeatureUsageQueryEngineElastica)

قيم ضبط إضافية في $wgApiFeatureUsageQueryEngineConf:

serverList

تسلسل خوادم Elasticsearch. مطلوب.

maxConnectionAttempts

العدد الأقصى لمحاولات الاتصال، القيمة الافتراضية هي 1.

indexPrefix

بادئة الفهارس المطلوب استخدامها. القيمة الافتراضية هي «apifeatureusage-».

indexFormat

صيغة التاريخ للفهارس المطلوب استخدامها، طالع دليل استخدام بي إتش بي. القيمة الافتراضية هي «Y.m.d».

type

أسلوب الطباعة والبحث مباشرة في Elasticsearch. القيمة الافتراضية هي «api-feature-usage-sanitized».

featureField

خانة الاسم للقيمة المسجلة للقيمة $feature. القيمة الافتراضية هي «feature».

timestampField

خانة الاسم للختم الزمني المسجل. القيمة الافتراضية هي «@timestamp».

agentField

خانة الاسم لعميل المستخدم المسجل. القيمة الافتراضية هي «agent».

الاستخدام

يضيف الامتداد صفحة خاصة، Special:ApiFeatureUsage، تحتوي على نموذج بسيط مخصص لطلب موجز لسجلات استخدام المزايا لعميل المستخدم مع تحديد مدة زمنية.

يضيف الامتداد أيضا وحدة برمجية فرعية لإرسال الاستفسارات عبر واجهة برمجة التطبيقات، meta=featureusage. طالع توثيق واجهة برمجة التطبيقات المولد آليا لمزيد من التفاصيل.

انظر أيضا

• Extension:Elastica

هذا الامتداد يستخدم على واحد من مشاريع ويكيميديا أو أكثر من واحد. يعني هذا الأمر أن الامتداد مستقر ويعمل/تعمل جيدا بما فيه الكفاية ليستخدم/لتستخدم في مواقع تتمتع بمستوى زيارات مرتفع مثل هذه. ابحث عن اسم هذا الامتداد في ملفات الضبط CommonSettings.php وكذلك InitialiseSettings.php كي ترى أين تنصب. توجد قائمة كاملة بالامتدادات المنصبة على موقع ويكي بعينه على صفحة Special:Version الخاصة بموقع الويكي.