Des mots clefs sur tout ce qu’on veut
Cette contrib fournit une nouvelle page pour l’interface privée permettant d’ajouter facilement des mots sur les éléments spip que l’on veut.
Pour illustrer la contrib, on va prendre comme exemple l’extension de la base de donnée spip pour ajouter des mots clefs sur les documents.
Nouvelles tables
Le première chose à faire est de créer une nouvelle table dans la base de donnée SPIP. Pour suivre les règles de nomage des tables spip, on va l’appeler spip_mots_documents (pensez à remplacer spip_ par le préfixe de vos tables).
Il faut donc, depuis phpMyAdmin ou autre, déclarer une table qui fait un mapping des id_documents vers les id_mots :
Il faut ensuite déclarer cette table à SPIP en ajoutant le code suivant dans votre fichier mes_fonctions :
On doit ensuite ajouter une colonne à la table des groupes de mots clefs pour qu’on puisse permettre l’ajout de mots clefs sur les documents :
bientôt intégré à l’interface de cette contrib :
Il faut aussi modifier cette colonne dans la table pour le groupe de mots qui nous intéresse (e.g. « Photos) » puisse être ajouté aux documents :
Interface d’ajout
Une nouvelle page pour l’interface privée, permettant d’ajouter des mots sur à peu près n’importe quoi a été développée.
- archive d’installation SPIP 1.8
pour les versions 1.8.2, il faut télécharger les fichiers disponibles ici puis les installer comme indiquer ci dessous.
Installation
- décompresser l’archive,
- placer mots_partout.php dans le répertoire ecrire,
- placer les fichiers motspartout_*.php dans le répertoire ecrire/lang,
Utilisation
Il faut se rendre sur la page de l’espace privé : ecrire/mots_partout.php, puis :
On peut limiter les documents affichés en spécifiant une liste — séparée par des virgules — de numéros de rubriques, d’articles ou de brèves.
Les mots sont affichés sur la gauche :
Les mots en vert sont ceux associés à tous les documents qui sont actuellement affichés.
Les mots en bleu sont ceux associés à une partie des documents affichés.
On peut voir les documents associés à des mots en les sélectionnant et en faisant « voir ». On verra alors les documents avec au moins un de ces mots.
Si on veut voir les documents qui ont au moins tous ces mots, il faut alors cocher la case « stricte ».
On peut exclure les documents associés à certains mots en cochant la case « sans » de ces mots.
On peut voir les mots associés à certains documents en sélectionnant les documents et faisant « voir ».
On peut ajouter des mots en les sélectionnant et en sélectionnant les documents. On fait ensuite « ajouter ».
On peut enlever des mots en les sélectionnant et en sélectionnant les documents. On fait ensuite « enlever ».
Internationalisation
La contrib vient avec 3 fichiers de localisation :
motspartout_fr.php pour l’interface en français,
motspartout_en.php pour l’interface en anglais,
motspartout_it.php pour l’interface en italien.
Si vous localisez ces fichiers dans d’autres langues, merci de me les faire parvenir (NdA : ou de les envoyer aux admins si vous n’avez pas de réponse de l’auteur, avec une petite explication), ils seront ajoutés à la contrib.
Des mots sur autre chose
En fait cette interface est faite pour mettre des mots sur n’importe quel objet spip.
On a pris l’exemple des documents et vous remarquerez qu’on peut déjà l’utiliser pour mettre des mots clefs sur les articles aussi.
On peut facilement étendre cette interface en ajoutant d’autres tables mots_documents comme expliqué plus haut. Il faut ensuite déclarer dans votre fichier mes_options certaines informations. Par exemple pour les brèves :
- L’index dans la table choses_possibles doit être le nom présent dans la table mots correspondante, par exemple : spip_mots_breves
- titre_chose est le nom de la chose sur laquelle on veut ajouter des mots, on peut localiser cette variable,
- id_chose est le nom de la colonne contenant l’id de la chose sur laquelle on veut ajouter des mots,
- table_principale est la table contenant toutes les choses sur lesquelles on veut ajouter des mots,
- table_auth est facultative. C’est la table qui lie les auteurs du site et la chose sur laquelle on veut ajouter des mots,
- tables_limite est un tableau de table que l’on peut utiliser pour limiter l’affichage (par exemple : les brèves de certaines rubriques, les brèves ayant certain documents) :
- table est le nom de la table,
- nom_id est le nom de la colonne sur laquelle on impose la limite.
affichage personnalisé
Au départ, l’interface va juste afficher une liste des identifiant, puisqu’elle ne sait pas comment afficher les nouveaux objets.
Si on veut un affichage adapté à l’objet sur lequel on travail, il faut ajouter dans mes_options sa propre fonction afficher_liste_choses où choses est le nom de la chose à afficher (i.e. le nom utilisé dans l’index de la table choses_possibles). Cette fonction prend un paramètre la liste des identifiant des choses à afficher.
Vous pouvez vous inspirer des articles ou des documents pour lesquels la table choses_possibles et les fonctions d’affichage sont fournies.
Version de développement
Cette contrib est gérée sur spip-zone, on peut récupérer la dernière version de développement grâce à :
svn checkout svn://zone.spip.org/spip-zone/_contrib_/_ecrire_/mots_partout/trunk/
le plugin "nuage", la différenciation de la taile des mots n’est pas prise en compte, je n’ai pas trouvé de solution
RSS 2.0