Jump to content

Manual:Hooks/APIEditBeforeSave

From mediawiki.org
APIEditBeforeSave
Available from version 1.13.0
Removed in version 1.34.0 (Gerrit change 519797)
Called right before saving an edit submitted through api.php?action=edit
Define function:
public static function onAPIEditBeforeSave( $editPage, $text, &$resultArr ) { ... }
Attach hook: In extension.json:
{
	"Hooks": {
		"APIEditBeforeSave": "MediaWiki\\Extension\\MyExtension\\Hooks::onAPIEditBeforeSave"
	}
}
Called from: File(s): api/ApiEditPage.php
Interface: APIEditBeforeSaveHook.php

For more information about attaching hooks, see Manual:Hooks .
For examples of extensions using this hook, see Category:APIEditBeforeSave extensions.

Details

[edit]
  • $editPage: the EditPage object
  • $text: the new text of the article (has yet to be saved)
  • $resultArr: data in this array will be added to the API result

Notes

[edit]

Return true to continue processing, return false to abort processing and reject the edit. If $resultArr was filled, the API will return an <edit result="Failure"> element with the contents of $resultArr added in. If $resultArr wasn't filled, the API will return an error message.