امتداد:ApiFeatureUsage

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

ApiFeatureUsage حالة الإصدار مستقر
تنفيذ	صفحة خاصة , واجهة برمجة التطبيقات
بيان	الوصول إلى موجز سجل استخدام سمة واجهة برمجة التطبيقات
المؤلف/المؤلفون	Brad Jorsch (Anomieنقاش)
آخر إصدار	1.0 (2016-12-07)
سياسة التوافق	تصدر اللقطات البرمجية مع ميدياويكي. الإصدار الرئيسي لا يتوافق مع الإصدارات السابقة.
MediaWiki	1.25+
PHP	5.5.9+
تغييرات قاعدة البيانات	لا
ترخيص	رخصة جنو العمومية 2.0 أو ما بعدها
التنزيل	تنزيل الامتداد غت [?]: تنزيل ملف غت الرئيسي تصفح المستودع (GitHub) تاريخ الالتزام مساهمو المستودع (غت هب) مراجعة الكود البرمجي
المتغيرات $wgApiFeatureUsageQueryEngineConf
الروابط المستخدمة ApiDeprecationHelp ApiLogFeatureUsage LoadExtensionSchemaUpdates
تنزيلات ربع سنوية	12 (Ranked 117th)
استخدام مواقع الويكي العمومية	847 (Ranked 303rd)
ترجم الامتداد 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 على موقع الويكي لديك كي تتحقق من أن الامتداد قد ثبت بنجاح.

الإعداد

المتغيرات

Name	Description
$wgApiFeatureUsageQueryEngineConf	سلسلة إعداد للولوج إلى تخزين السجل مباشرة. class فئة الولوج المباشر المطلوب تمثيلها. يتطلب الأمر هذا أو factory بديلا عنه. factory نداء بي إتش بي يتعين أن يرجع له حالة فئة ولوج مباشر. يتطلب الأمر هذا أو class بديلا عنه.

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