Manual:Hooks/TitleMoveComplete

From MediaWiki.org
Jump to: navigation, search
Warning Warning: For MediaWiki 1.27 and higher the third parameter needs to be declared as $user and not &$user. This is a known bug; see phab:T118683 for details. (If your hook function does not modify the User object, you can simply change the parameter to $user and it will work correctly across all MediaWiki versions.)
TitleMoveComplete
Available from version 1.4.0
Occurs whenever a request to move an article is completed, after the database transaction commits.
Define function:
public static function onTitleMoveComplete( Title &$title, Title &$newTitle, User &$user, $oldid, $newid, $reason, Revision $revision ) { ... }
Attach hook:

In extension.json:

{
	"Hooks": {
		"TitleMoveComplete": [
			"MyExtensionHooks::onTitleMoveComplete"
		]
	}
}

For MediaWiki ≤1.25:

$wgHooks['TitleMoveComplete'][] = 'MyExtensionHooks::onTitleMoveComplete';
Called from: File(s): Title.php
Function(s): MovePage::move()

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

Details[edit]

  • $title: old Title
  • $newTitle: new Title
  • $user: User who did the move
  • $oldid: database page_id of the page that's been moved
  • $newid: database page_id of the created redirect, or 0 if the redirect was suppressed.
  • $reason: reason for the move; added in git #6f106156 (version 1.23)
  • $revision: revision created by the move; added in git #9cc2f62b (version 1.27)

See also[edit]