Manual:Hooks/UserEffectiveGroups
| UserEffectiveGroups | |
|---|---|
| Available from version 1.11.0 Dynamically add or remove to the default user groups provided by the database table User groups table | |
| Define function: | public static function onUserEffectiveGroups( &$user, &$aUserGroups ) { ... }
|
| Attach hook: | In extension.json:
{
"Hooks": {
"UserEffectiveGroups": "MediaWiki\\Extension\\MyExtension\\Hooks::onUserEffectiveGroups"
}
}
|
| Called from: | File(s): User.php |
| Interface: | UserEffectiveGroupsHook.php |
For more information about attaching hooks, see Manual:Hooks.
For examples of extensions using this hook, see Category:UserEffectiveGroups extensions.
Use cases
[edit]The UserEffectiveGroups hook lets MediaWiki installations filter and add to the list of user groups stored in the MediaWiki database. For example, one might wish to synchronize the user groups with the host operating system or with a third party package.
Usage
[edit]At the time of invocation $aUserGroups is populated with the groups assigned to the user by the User groups table. Functions attached to this hook change the groups by adding or removing array elements.