La fonction de ce plugin est de sélectionner le "bon" squelette quand il y a plusieurs possibilités. Par exemple quand il existe un squelette d’article album photo et un squelette d’article ordinaire. Cette fonction existe déjà dans Spip avec des numéros de rubriques : tous les articles d’une rubrique peuvent avoir un même squelette différent du reste du site. Ce plugin permet un selection plus fine en permettant de choisir le squelette pour un article ou une rubrique en fonction d’un mot clef qui lui est associé. Le plugin va ajouter cette nouveauté en se substituant à Spip pour la partie recherche de squelette.
La sélection de squelette par mot-clé peut toujours se faire avec une boucle (voir ici comment) mais le Plugin est supposé plus performant. D’un point de vue mise en place, il faut troquer la boucle traditionnelle contre une approche installation et configuration du Plugin.
Le Plugin en action lors d’un appel de page
Lorsqu’un article, par exemple, est demandé, le plugin fonctionne comme ceci :
- s’il existe un fichier "article=10.html" et que l’article demandé se trouve dans la rubrique N° 10, alors ce fichier sera retenu comme squelette
- s’il existe un fichier "article-10.html" et que l’article demandé se trouve dans la rubrique N° 10 ou encore dans une de ses sous-rubriques sans limitation de profondeur, alors ce fichier sera retenu comme squelette
- s’il existe un fichier "article-album.html" et que l’article demandé est lié à un mot-clé "album" reconnu comme sélecteur de squelette [1], alors ce fichier sera retenu comme squelette
- s’il existe un fichier "article-album.html" et que l’article demandé se trouve dans une rubrique ou encore dans une de ses sous-rubriques sans limitation de profondeur, qui est liée à un mot-clé "album" reconnu comme sélecteur de squelette, alors ce fichier sera retenu comme squelette
- si rien n’a été retenu jusqu’ici, "article.html" sera l’élu.
La recherche s’effectue dans l’ordre précédent en respectant la logique qui a toujours prévalu avant dans SPIP : le plugin ajoute simplement les étapes 3 et 4, avec une même notation qui évite les duplications ou renommages de fichiers squelette.
De plus, le Plugin prend en considération la langue du site ; ainsi pour le Français, il retiendra article-album.fr.html de préférence à article-album.html suivant la notation habituelle de SPIP pour les suffixes de langue.
La mise en oeuvre du Plugin par le Webmestre
On suppose que notre squelette d’album est en place (/squelettes/article-album.html), et que le mot clé "album" a été créé avec possibilité d’être associé à des articles ou à des rubriques.
Installation
Après avoir téléchargé le plugin sur le serveur de fichier de la Zone :
Il faut le décompresser et transférer le répertoire chercher_squelettes_mots par ftp sur votre serveur dans le répertoire plugin.
Activation
L’étape suivante consiste à activer le Plugin, ce qui est fait au moyen du bouton de gestion de Plugin qu’on trouve dans la partie privée de SPIP (à partir de SPIP 1.9).
Le premier effet de cette activation est que l’on voit apparaître un nouvel onglet dans la page de configuration du site (Cf. "Configurer Squelette Mots" à droite dans l’image ci dessus). C’est par lui qu’on va pouvoir déclarer les mot-clés reconnus par le Plugin [2]. Tant que rien n’est configuré le Plugin passera de l’étape 2 à l’étape 5, comme le ferait la fonction "chercher squelette" du noyau, puisque le Plugin a pris la main sur Spip pour la recherche du bon squelette (second effet de l’activation).
Configuration
Il est temps maintenant d’entrer une "règle" dans le configurateur du Plugin. Celle-ci permet de déclarer "album" comme mot-clé sélecteur de squelette en lui associant un "type" [3] ; dans notre exemple : article. Une règle associe un groupe de mot à un type. L’exemple qui suit montre que le Plugin détecte 2 mots-clés dans le groupe "groupe squelette article" : album et toto en affichant les noms de fichiers squelette correspondants en vert (trouvé) ou en rouge (pas trouvé).
On pourra ajouter autant de régles que l’on veut tant que l’on crée les squelettes et mot-clés correspondants. Le reste relève alors des rédacteurs/administrateurs qui n’ont plus qu’à ajouter le mot-clé "album" aux articles qu’ils souhaitent (par exemple).
On a vu que le mot-clé est associé à un article (le type) dans une règle, alors qu’il peut être ajouté indifféremment à des rubriques ou à des articles. Bien que le rédacteur n’ait aucune visibilité sur le configurateur, il doit comprendre qu’un mot-clé sélecteur appliqué sur une rubrique aura un effet sur la présentation des articles de cette rubrique car, comme Mr. Jourdain, il manipule des squelettes sans le savoir. Si cette logique est trop déroutante, l’administrateur peut toujours restreindre le champ d’application du mot-clé aux seuls articles. [4]
Fond
L’administrateur peut préciser le "fond" dans une règle. Ce fond est le préfixe du squelette, par exemple, pour article-album.html c’est "article", pour rubrique-album.html, c’est "rubrique", etc...
Attention : Il ne faut pas confondre la valeur du fond avec le type d’objet affiché dans l’article (article, rubrique) ni avec le nom du groupe de mot clef de la règle. Le fond permet simplement d’appliquer la règle à d’autres pages que les pages de base de SPIP.
Ce raffinement peut être vu comme une complication, mais cela à l’avantage de faire accepter les règles pour des squelettes d’inclusion (des bouts de squelette donc) et pas seulement sur des squelettes complets.
Attention : Pour que les règles marchent sur les inclusions, il faut que celles-ci aient l’id de l’objet (article, rubique, etc...) dans le context, par exemple :
.
RSS 2.0
