C'est probablement la méthode que vous utiliserez le plus avec jAcl2. Elle permet de savoir si l'utilisateur a tel ou tel droit, et renvoie donc true ou false. C'est une méthode statique. Exemple :

if( jAcl2::check("cms.articles.create")){
   // code à exécuter si l'utilisateur a le droit de créer un article

}else{
   // code à exécuter si l'utilisateur n'a pas le droit de créer un article
}

Pour interroger sur une ressource précise :

$article_id = "opinions";

if( jAcl2::check("cms.articles.update", $article_id)){
   // code à exécuter si l'utilisateur a le droit de modifier l'article indiqué

}else{
   // code à exécuter si l'utilisateur n'a pas le droit de modifier l'article indiqué
}

L'installateur du module jacl2db installe le plugin jacl2 pour le coordinateur. Il vérifie automatiquement les droits d'une action avant l'exécution d'un contrôleur.

Vous devriez donc avoir ceci dans la configuration :

[coordplugins]
jacl2 = "index/jacl2.coord.ini.php"

Et avoir donc un fichier var/config/index/jacl2.coord.ini.php. Ce fichier contient la configuration du plugin :

on_error=2
error_message="jacl2~errors.action.right.needed"
on_error_action="jelix~error:badright"

• on_error doit être égal à 1 pour les points d'entrée des service web (soap, jsonrpc, xmlrpc...).
• error_message indique le selecteur de la chaine localidée contenant un message d'erreur, affiché quand les droits ne sont pas bons
• on_error_action indique le selecteur de l'action où l'application doit redirigé si la vérification échoue.

Le plugin essaiera de récupérer les paramètres de plugins suivant dans les contrôleurs : jacl2.right, jacl2.rights.and, jacl2.rights.or. Ces paramètres doivent contenir des noms de sujets de droits. Le plugin testera donc si l'utilisateur a les droits indiqués.

Pour vérifier un seul droit, utilisez jacl2.right :

   public $pluginParams = array(
        '*' => array( 'jacl2.right'=>'sujet', ...)
        ...
   );

Pour vérifier une série de droits que l'utilisateur doit posséder, utilisez jacl2.rights.and :

   public $pluginParams = array(
     '*' => array( 'jacl2.rights.and'=>array('sujet1', 'sujet2', ..)
            ),
        ...
   );

Ou encore, pour vérifier que l'utilisateur possède un des droits parmi une liste, utilisez jacl2.rights.or :

   public $pluginParams = array(
     '*' => array( 'jacl2.rights.or'=>array('sujet1', 'sujet2', ..)
            ),
        ...
   );

Des plugins de templates sont disponibles pour générer des portions de contenus en fonction des droits. Leurs arguments sont exactement les mêmes que jAcl2::check().

  {ifacl2 "cms.articles.create"}
    <input type="button" value="Créer un article" />
  {else}
   <p>Vous ne pouvez pas créer d'articles.</p>
  {/ifacl2}

Il y aussi {ifnotacl2}, le contraire de {ifacl2}, c'est à dire qui teste si l'utilisateur n'a pas le droit indiqué.

La même chose avec une ressource :

  {ifacl2 "cms.articles.update", $article_id}
    <input type="button" value="Modifier l'article" />
  {/ifacl2}