Le pipeline « autoriser » est particulier. Il permet simplement de charger des fonctions d’autorisations au tout premier appel de la fonction autoriser()
. Ce pipeline ne transmet rien et ne reçoit rien.
pipeline('autoriser');
Grâce à lui, un plugin peut déclarer des autorisations spécifiques, regroupées dans un fichier « prefixePlugin_autorisations.php » et les déclarer, dans plugin.xml
comme ceci :
<pipeline>
<nom>autoriser</nom>
<inclure>prefixePlugin_autorisations.php</inclure>
</pipeline>
Outre les fonctions d’autorisations, le fichier doit contenir la fonction appelée par tous les pipelines (« prefixePlugin_nomDuPipeline() ») mais elle n’a rien a effectuer. Un exemple :
function prefixePlugin_autoriser(){}
Attention ! l’exemple donné ci-dessous comporte un piège : le forum dans le nom des fonctions d’autorisation est le type d’objet concerné. Il se trouve que le type forum s’appelle pareil que le préfixe du plugin forum, mais c’est un cas particulier. Utilisez le type ! [1]
On peut aussi avoir simplement besoin de Donner une autorisation exceptionnelle.