Manual:Hooks/LocalUserCreated

LocalUserCreated
Available from version 1.26.0
Called immediately after a local user has been created and saved to the database
Define function:
public static function onLocalUserCreated( $user, $autocreated ) { ... }
Attach hook: In extension.json:
{
	"Hooks": {
		"LocalUserCreated": "MediaWiki\\Extension\\MyExtension\\Hooks::onLocalUserCreated"
	}
}
Called from: File(s): auth/AuthManager.php
Interface: LocalUserCreatedHook.php

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


Details

  • $user - User object for the created user
  • $autocreated - Boolean, whether this was an auto-creation. Note if your wiki uses CentralAuth this will always be true.

Notes

Added in MediaWiki 1.26 as part of the AuthManager system. Replaces the AuthPlugin::initUser() method call and the AddNewAccount and AuthPluginAutoCreate hooks.

Extensions which implement their own authentication provider might want to use AuthManager::autoCreatedAccount and AuthManager::postAccountCreation instead, which are similar but have access to more information. (Note that postAccountCreation is called significantly later in the process, after secondary authentication providers have finished.)

Changes which are not immediately required for database consistency should probably be deferred; see Database transactions .

If $wgAutoCreateTempUser is active, this hook is also called when a temporary account is automatically created for a logged-out user.


See also