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

29 lines
881 B
PHP

<?php
namespace MediaWiki\User\Hook;
use User;
/**
* This is a hook handler interface, see docs/Hooks.md.
* Use the hook name "PingLimiter" to register handlers implementing this interface.
*
* @stable to implement
* @ingroup Hooks
*/
interface PingLimiterHook {
/**
* Use this hook to override the results of User::pingLimiter().
*
* @since 1.35
*
* @param User $user User performing the action
* @param string $action Action being performed
* @param bool &$result Whether or not the action should be prevented
* Change $result and return false to give a definitive answer, otherwise
* the built-in rate limiting checks are used, if enabled.
* @param int $incrBy Amount to increment counter by
* @return bool|void True or no return value to continue or false to abort
*/
public function onPingLimiter( $user, $action, &$result, $incrBy );
}