Jump to content

Manual:Hooks/PageContentSaveComplete

From mediawiki.org
PageContentSaveComplete
Available from version 1.21.0
Removed in version 1.37.0 (Gerrit change 678414)
Occurs after the save page request has been processed
Define function:
public static function onPageContentSaveComplete( $wikiPage, $user, $mainContent, $summaryText, $isMinor, $isWatch, $section, $flags, $revision, $status, $originalRevId, $undidRevId ) { ... }
Attach hook: In extension.json:
{
	"Hooks": {
		"PageContentSaveComplete": "MediaWiki\\Extension\\MyExtension\\Hooks::onPageContentSaveComplete"
	}
}
Called from: File(s): Storage/PageUpdater.php
Interface: PageContentSaveCompleteHook.php

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


Details

[edit]
  • $wikiPage: WikiPage modified
  • $user: User performing the modification
  • $mainContent: New content, as a Content object
  • $summary: Edit summary/comment
  • $isMinor: Whether or not the edit was marked as minor
  • $isWatch: (No longer used)
  • $section: (No longer used)
  • $flags: Flags passed to WikiPage::doEditContent()
  • $revision: Revision object of the saved content. If the save did not result in the creation of a new revision (e.g. the submission was equal to the latest revision), this parameter may be null (null edits, or "no-op"). However, there are reports (see phab:T128838) that it's instead set to that latest revision.
  • $status: Status object about to be returned by doEditContent()
  • $originalRevId: If the edit restores or repeats an earlier revision (such as a rollback or a null revision), the ID of that earlier revision. False otherwise.
  • $undidRevId: the rev ID (or 0) this edit undid 1.30+

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.

Example handler

[edit]
/**
 * Occurs after the save page request has been processed.
 *
 * @param WikiPage $wikiPage
 * @param User $user
 * @param Content $content
 * @param string $summary
 * @param bool $isMinor
 * @param null $isWatch Unused
 * @param null $section Unused
 * @param int $flags
 * @param Revision|null $revision
 * @param Status $status
 * @param int|false $originalRevId
 * @param int $undidRevId
 *
 * @return boolean
 * @see https://www.mediawiki.org/wiki/Manual:Hooks/PageContentSaveComplete
 */
public static function onPageContentSaveComplete(
    $wikiPage, $user, $content, $summary, $isMinor, $isWatch, $section, $flags,
    $revision, $status, $originalRevId, $undidRevId
) {
# ...
}

See also

[edit]