Jump to content

دليل:وصلات/APIEditBeforeSave

From mediawiki.org
This page is a translated version of the page Manual:Hooks/APIEditBeforeSave and the translation is 100% complete.
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‎، سوف ترد واجهة برمجية التطبيقات رسالة خطأ.