Available from version 1.24.0 (Gerrit change 144689)
Removed in version 1.38.0 (Gerrit change 723014)
Allows changing the behavior when a user's preferences are reset. For instance, certain preferences can be preserved.
Define function:
public static function onUserResetAllOptions( User $user, array &$newOptions, array $oldOptions, $resetKinds ] ); ) { ... }
Attach hook: In extension.json:
	"Hooks": {
		"UserResetAllOptions": "MediaWiki\\Extension\\MyExtension\\Hooks::onUserResetAllOptions"
Called from: File(s): User.php
Function(s): User::resetOptions
Interface: UserResetAllOptionsHook.php

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


  • User $user: User whose preferences are being reset.
  • array &$newOptions: New preferences as associative array.
  • array $oldOptions: Old preferences as associative array.
  • array|string resetKinds: Kinds of preferences to reset as an array or string; see User::resetOptions for possible values.