wiki.techinc.nl/includes/user/Hook/UserGroupsChangedHook.php
daniel 2e57447c58 Document hook names in hook interfaces.
Bug: T258665
Change-Id: Ifddbf57f8aa2e3eb0d5845601376cbafa08ed407
2020-09-27 12:03:12 +02:00

42 lines
1.2 KiB
PHP

<?php
namespace MediaWiki\User\Hook;
use User;
use UserGroupMembership;
/**
* This is a hook handler interface, see docs/Hooks.md.
* Use the hook name "UserGroupsChanged" to register handlers implementing this interface.
*
* @stable to implement
* @ingroup Hooks
*/
interface UserGroupsChangedHook {
/**
* This hook is called after user groups are changed.
*
* @since 1.35
*
* @param User $user User whose groups changed
* @param string[] $added Groups added
* @param string[] $removed Groups removed
* @param User|false $performer User who performed the change, false if via autopromotion
* @param string|false $reason The reason, if any, given by the user performing the change,
* false if via autopromotion.
* @param UserGroupMembership[] $oldUGMs An associative array (group name => UserGroupMembership)
* of the user's group memberships before the change.
* @param UserGroupMembership[] $newUGMs An associative array (group name => UserGroupMembership)
* of the user's current group memberships.
* @return bool|void True or no return value to continue or false to abort
*/
public function onUserGroupsChanged(
$user,
$added,
$removed,
$performer,
$reason,
$oldUGMs,
$newUGMs
);
}