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é
}

Une valeur vide ou "-" pour l'identifiant de la ressource indique "pour toute ressource". Avant Jelix 1.4.1, seule la valeur vide spécifié cet état.

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}