دليل:وصلات/APIEditBeforeSave
 | رفعت هذه السمة من لب برمجيات ميدياويكي في إصدار 1.34.0 (بعد أن أصبحت متقادمة في 1.28.0). يرجى مراجعة EditFilterMergedContent للاطلاع على سبل بديلة لاستخدام هذه السمة. |
| APIEditBeforeSave | |
|---|---|
| متوفر بدءً من الإصدار 1.13.0 رفع في الإصدار 1.34.0 (Gerrit change 519797) يستدعى قبيل حفظ تعديل أرسل باستخدام api.php?action=edit | |
| تعريف الوظيفة: | public static function onAPIEditBeforeSave( $editPage, $text, &$resultArr ) { ... }
|
| وصلة الربط الشبكية: | في extension.json:
{
"Hooks": {
"APIEditBeforeSave": "MediaWiki\\Extension\\MyExtension\\Hooks::onAPIEditBeforeSave"
}
}
|
| تستدعى من: | ملف/ملفات: api/ApiEditPage.php |
| واجهة: | APIEditBeforeSaveHook.php |
لمزيد من المعلومات المتعلقة بإضافة وصلة شبكية، طالع دليل:وصلات.
كي تطلع على أمثلة على امتدادات تستخدم هذا الرابط، طالع Category:APIEditBeforeSave extensions/ar.
التفاصيل
- $editPage: عنصر EditPage
- $text: النص الجديد للمقالة (لم يحفظ بعد)
- $resultArr: سوف تضاف البيانات في هذه المتوالية إلى نتائج واجهة برمجة التطبيقات
ملاحظات
رد «true» كي تواصل المعالجة، رد «false» لوقف المعالجة ورفض التعديل.
لو كان ثمة قيمة في $resultArr، سوف ترد واجهة برمجية التطبيقات عنصر <edit result="Failure"> مع محتوى $resultArr مضاف إليه.
لو لم تكن قيمة في $resultArr، سوف ترد واجهة برمجية التطبيقات رسالة خطأ.