امتداد:ApiFeatureUsage
ApiFeatureUsage حالة الإصدار مستقر |
|
---|---|
تنفيذ | صفحة خاصة , واجهة برمجة التطبيقات |
بيان | الوصول إلى موجز سجل استخدام سمة واجهة برمجة التطبيقات |
المؤلف/المؤلفون | Brad Jorsch (Anomieنقاش) |
آخر إصدار | 1.0 (2016-12-07) |
سياسة التوافق | تصدر اللقطات البرمجية مع ميدياويكي. الإصدار الرئيسي لا يتوافق مع الإصدارات السابقة. |
MediaWiki | 1.25+ |
PHP | 5.5.9+ |
تغييرات قاعدة البيانات | لا |
ترخيص | رخصة جنو العمومية 2.0 أو ما بعدها |
التنزيل | |
|
|
تنزيلات ربع سنوية | 16 (Ranked 116th) |
استخدام مواقع الويكي العمومية | 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
|
سلسلة إعداد للولوج إلى تخزين السجل مباشرة.
|
- 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
.
طالع توثيق واجهة برمجة التطبيقات المولد آليا لمزيد من التفاصيل.
انظر أيضا
هذا الامتداد يستخدم على واحد من مشاريع ويكيميديا أو أكثر من واحد. يعني هذا الأمر أن الامتداد مستقر ويعمل/تعمل جيدا بما فيه الكفاية ليستخدم/لتستخدم في مواقع تتمتع بمستوى زيارات مرتفع مثل هذه. ابحث عن اسم هذا الامتداد في ملفات الضبط CommonSettings.php وكذلك InitialiseSettings.php كي ترى أين تنصب. توجد قائمة كاملة بالامتدادات المنصبة على موقع ويكي بعينه على صفحة Special:Version الخاصة بموقع الويكي. |