Manuel:Accroches/getUserPermissionsErrors

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Hooks/getUserPermissionsErrors and the translation is 100% complete.

Other languages:
English • ‎français • ‎日本語
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 un rappel (hook) :

In extension.json:

{
	"Hooks": {
		"getUserPermissionsErrors": "MyExtensionHooks::ongetUserPermissionsErrors"
	}
}

For MediaWiki ≤1.25:

$wgHooks['getUserPermissionsErrors'][] = 'MyExtensionHooks::ongetUserPermissionsErrors';
Appelé de :Fichier(s) : Permissions/PermissionManager.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. Si aucun, renvoie true. $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 ...?).

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).

Voir aussi