MediaWiki master
MediaWiki\Permissions\Hook\GetUserPermissionsErrorsHook Interface Reference

This is a hook handler interface, see docs/Hooks.md. More...

Inherited by MediaWiki\HookContainer\HookRunner.

Public Member Functions

 onGetUserPermissionsErrors ( $title, $user, $action, &$result)
 Use this hook to add a permissions error when permissions errors are checked for.
 

Detailed Description

This is a hook handler interface, see docs/Hooks.md.

Use the hook name "getUserPermissionsErrors" to register handlers implementing this interface.

Stability: stable
to implement

Definition at line 16 of file GetUserPermissionsErrorsHook.php.

Member Function Documentation

◆ onGetUserPermissionsErrors()

MediaWiki\Permissions\Hook\GetUserPermissionsErrorsHook::onGetUserPermissionsErrors ( $title,
$user,
$action,
& $result )

Use this hook to add a permissions error when permissions errors are checked for.

Use instead of userCan for most cases. Return false if the user can't do it, and populate $result with the reason in the form of [ messagename, param1, param2, ... ] or a MessageSpecifier instance (you might want to use ApiMessage to provide machine-readable details for the API).

Since
1.35
Parameters
Title$titleTitle being checked against
User$userCurrent user
string$actionAction being checked
array | string | MessageSpecifier&$resultUser permissions error to add. If none, return true. For consistency, error messages should be plain text with no special coloring, bolding, etc. to show that they're errors; presenting them properly to the user as errors is done by the caller.
Returns
bool|void True or no return value to continue or false to abort

Implemented in MediaWiki\HookContainer\HookRunner.


The documentation for this interface was generated from the following file: