Manuel:Accroches/getUserPermissionsErrors
| getUserPermissionsErrors | |
|---|---|
| Disponible depuis version 1.12.0 Ajoute un erreur concernant les droits d'accès lorsque ceux-ci doivent être vérifiés. | |
| Fonction à définir : | public static function ongetUserPermissionsErrors( $title, $user, $action, &$result ) { ... }
|
| Attacher l'accroche : | Dans extension.json :
{
"Hooks": {
"getUserPermissionsErrors": "MediaWiki\\Extension\\MyExtension\\Hooks::ongetUserPermissionsErrors"
}
}
|
| Appelé de : | Fichier(s) : Permissions/PermissionManager.php |
| Interface : | getUserPermissionsErrorsHook.php |
Pour plus d'information sur l'ajout des accroches (hooks), voir Manuel:Accroches.
Pour des exemples d'extensions utilisant cette accroche, voir Category:getUserPermissionsErrors extensions/fr .
Détails
- $title - Objet titre à vérifier
- $user - Objet utilisateur actuel
- $action - Action en cours de vérification
- &$result - Erreur de droit utilisateur à ajouter. $result peut être rendu comme une simple clé de message d'erreur (chaîne de caractères), ou comme un tableau de clés de messages d'erreur quand plusieurs messages sont nécessaires (bien qu'il semble utiliser un tableau comme une clé de message avec des paramètres ...?).
<span id="Differences_from_getUserPermissionsErrorsExpensive">
Différences avec getUserPermissionsErrorsExpensive
Les deux accroches sont typiquement exécutées lorsqu'il faut vérifier les droits adéquats dans Title.php. Lorsque l'on veut sauter potentiellement les contrôles en cascades qui prennent du temps, seulement getUserPermissionsErrors est éxécuté. Ce comportement convient pour les contrôles d'IHM non essentiels dans les cas habituels, mais pas pour le contrôle d'accès fonctionnel. Ce comportement peut produire des faux positifs (erreur signalée à tord) mais jamais de faux négatifs (pas d'erreur signalée alors qu'il en existe).