Manual:Hooks/ArticleSaveComplete
Jump to navigation
Jump to search
![]() | This deprecated feature should no longer be used, but is still available for reasons of backwards compatibility. This feature was deprecated in version 1.21.0. Please see PageContentSaveComplete for an alternative way to use this feature. |
![]() | This feature was removed from MediaWiki core in version 1.29.0. Please see PageContentSaveComplete for an alternative way to use this feature. |
ArticleSaveComplete | |
---|---|
Available from version 1.4.0 Removed in version 1.29.0 Occurs after the save article request has been processed. |
|
Define function: |
public static function onArticleSaveComplete( &$article, &$user, $text, $summary, $minoredit, $watchthis, $sectionanchor, &$flags, $revision, &$status, $baseRevId ) { ... }
|
Attach hook: |
In extension.json: {
"Hooks": {
"ArticleSaveComplete": "MyExtensionHooks::onArticleSaveComplete"
}
}
For MediaWiki ≤1.25: $wgHooks['ArticleSaveComplete'][] = 'MyExtensionHooks::onArticleSaveComplete';
|
Called from: | File(s): WikiPage.php |
For more information about attaching hooks, see Manual:Hooks.
For examples of extensions using this hook, see Category:ArticleSaveComplete extensions.
Contents
Details[edit]
- $article: the Article (object) saved
- $user: the User (object) who saved the article
- $text: the new article text
- $summary: the article summary (comment)
- $minoredit: minor flag
- $watchthis: not used as of 1.8
- $section: not used as of 1.8
- $flags: bitfield, see includes/Article.php for details
- $revision: the new Revision object that was just saved or NULL if the user clicked save without changing any page text 1.11+
- $status: the Status object that will be returned by
Article::doEdit()
1.14+ - $baseRevId: revision ID on which this edit is based 1.15+
The function should return true to continue hook processing or false to abort. This hook will be triggered both by edits made through the edit page, and by edits made through the API.
Notes[edit]
This did not apply to newly uploaded images until v1.4.5.
- Version 1.4.x - 1.5.x: included in EditPage.php and Image.php.
- Version 1.6.x - 1.10.x:included in Article::updateArticle() and Article::insertArticle().
- Version 1.11+: included in Article::doEdit().
- Version 1.18+: moved to WikiPage.php
insertNewArticle() and updateArticle() will watch/unwatch pages after doEdit() (and hence ArticleSaveComplete) are run.
Example handler[edit]
/**
* Occurs after the save article request has been processed.
* @see https://www.mediawiki.org/wiki/Manual:Hooks/ArticleSaveComplete
*
* @param WikiPage $article
* @param User $user
* @param string $text
* @param string $summary
* @param boolean $minoredit
* @param boolean $watchthis
* @param $sectionanchor deprecated
* @param integer $flags
* @param Revision $revision
* @param Status $status
* @param integer $baseRevId
*
* @return boolean
*/
public static function onArticleSaveComplete( WikiPage &$article, User &$user, $text, $summary,
$minoredit, $watchthis, $sectionanchor, &$flags, Revision $revision, Status &$status, $baseRevId ) {
}