wiki.techinc.nl/includes/api/Hook/APIQueryUsersTokensHook.php
apaskulin c44488f725 docs: Hook interface doc comment review
Edited doc comments for hook interfaces to improve
consistency and add type hints.

Bug: T246855
Change-Id: I38fa802463cd6f39bf5946dbbeb1b3ebaea604b2
2020-04-21 09:10:08 +10:00

25 lines
853 B
PHP

<?php
namespace MediaWiki\Api\Hook;
/**
* @deprecated since 1.24 Use ApiQueryTokensRegisterTypes instead.
* @ingroup Hooks
*/
interface APIQueryUsersTokensHook {
/**
* Use this hook to add custom token to list=users. Every token has an action,
* which will be used in the ustoken parameter and in the output
* (actiontoken="..."), and a callback function which should return the token, or
* false if the user isn't allowed to obtain it. The prototype of the callback
* function is func($user) where $user is the User object. In the hook, add
* your callback to the $tokenFunctions array and return true (returning false
* makes no sense).
*
* @since 1.35
*
* @param array &$tokenFunctions [ action => callback ]
* @return bool|void True or no return value
*/
public function onAPIQueryUsersTokens( &$tokenFunctions );
}