Manual:Hooks/UserRights
 | This feature was removed from MediaWiki core in version 1.34.0 (after being deprecated in 1.26.0). Please see UserGroupsChanged for an alternative way to use this feature. |
| UserRights | |
|---|---|
| Available from version 1.6.0 Removed in version 1.34.0 (Gerrit change 518324) Called after a user's group memberships are changed | |
| Define function: | public static function onUserRights( $user, array $add, array $remove ) { ... }
|
| Attach hook: | In extension.json:
{
"Hooks": {
"UserRights": "MediaWiki\\Extension\\MyExtension\\Hooks::onUserRights"
}
}
|
| Called from: | File(s): specials/SpecialUserrights.php |
| Interface: | UserRightsHook.php |
For more information about attaching hooks, see Manual:Hooks.
For examples of extensions using this hook, see Category:UserRights extensions.
Details
[edit]- $user: User or UserRightsProxy object that was changed
- $add: Array of strings corresponding to groups added
- $remove: Array of strings corresponding to groups removed
If the $user parameter was a UserRightsProxy object, this user rights change was performed on a different wiki. This means that you might be mislead into identifying a user based on information such a name or ID because they do not share that attribute on the local wiki - it will almost certainly point to a different user entirely.
Additionally, the $user parameter could be a CentralAuthGroupMembershipProxy object from Extension:CentralAuth in the case of a global user rights change. The information given by this object represents a global account shared across wikis, and the ID will not match the attached local account IDs.
See also
[edit]- UserGroupsChanged - replaces this hook
- UserGetRights - provide user rights dynamically