wiki:MotsPartout

Retour LesPlugins

Etat fonctionnel

Description Passage en plugin de la contrib http://www.spip-contrib.net/Des-mots-clefs-partout

Installation

Telectharger http://zone.spip.org/files/spip-zone/mots-partout_1_9_1.zip

decompresser, placer dans le repertoire plugins à la racine de votre site.

Configuration

Aller dans le panneau Configuration > Configuration Mots Partout. Choisir sur quels objets vous voulez installer le plugin

Mots Partout

C'est une nouvelle interface pour l'interface privée pour ajouter des mots sur n'importe quel "objet" (articles, rubriques, documents, auteurs, ...), en particulier de façon efficace sur les documents.

Utilisation

L'interface est divisée en trois parties majeure:

la colonne du milieu

affiche une liste d'objets -- quand on parle d'objets ici, on se réfère aux articles, documents, etc... --. Cette liste, au départ contient tous les objets du type sélectionné (voir plus bas) paginés par page de 20.

le choix du type

par défaut, les objets affichés sont les articles. On peut changer cela en sélectionnant un nouveau type d'objet. Ici, seul les types configurés depuis la page de configuration sont affiché.

En changeant le type, la colonne du milieu affichera tous les objets du nouveau type, paginé par 20. On peut alors choisir une limitation à l'affichage et changer le nombre d'objets par page.

Chaque type a des limitations différentes, mais par exemple, pour les articles, on peut limiter la liste d'articles aux articles d'une certaine rubrique ou d'un certain auteur.

les actions

Cette partie est la plus importante de la page.

On voit la liste de mots-clefs (par groupe) qui sont associable au type d'objet sélectionné. Les mots-clefs sont colorés de trois façons:

  • en gris s'ils ne sont associés à aucun objet affiché dans la liste au milieu
  • en bleu s'ils sont associés à certain (mais pas tous) des objets dans la liste
  • en vert s'ils sont associés à tous les objets dans la liste du milieu

On peut sélectionner différente action pour chaque mot-clef:

  • voir: affichera les objets qui ont ce mot-clef
  • cacher: exclura de la liste les objets qui ont ce mot-clef
  • ajouter: ajoutera ce mot-clef à tous les objets sélectionnés dans la liste
  • enlever: enlever ce mot-clef de tous les objets sélectionnés dans la liste

Une fois que vous avez sélectionné l'action pour tous les mots-clefs qui vous interessent, il suffit de valider. Si vous avez sélectionné voir ou cacher, alors la liste à droite affichera les objets correspondant. Si vous avez sélectionné ajouter ou enlever, la liste affichera les objets sur lesquels vous venez de faire une modification.

Des mots sur autre chose

En fait cette interface est faite pour mettre des mots sur n’importe quel objet spip.

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:

$choses_possibles['breves'] = array(
                                      'titre_chose' => 'breves',
                                      'id_chose' => 'id_breve',
                                      'table_principale' => 'spip_breves',
                                      'table_auth' => 'spip_auteurs_breves',
                                      'tables_limite' => array(
                                                               'breves' => array(
                                                                                   'table' => 'spip_breves',
                                                                                   'nom_id' => 'id_breve'),
                                                               'rubriques' => array(
                                                                                    'table' => 'spip_articles',
                                                                                    'nom_id' =>  'id_rubrique'),
                                                               'documents' => array(
                                                                                    'table' => 'spip_documents_breves',
                                                                                    'nom_id' =>  'id_document'))
                                                               )
                                      );
  • 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):

o table est le nom de la table, o 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 (voir le fichier inc/choses.php)

Technique

Voici ce qu'en dit l'auteur quant à son fonctionnement (c'est plutôt technique) :

« Normalement, il y a un fichier mots_partout_choses.php qui donne des définitions des tables qui peuvent avoir des mots, il y a normalement tout ce qu'il faut pour les auteurs là dedans.

« Apres, il y a une page de configuration avec juste un select au milieu qui liste les tables qui sont déclarée dans mots_partout_choses mais pas encore créées. C'est depuis cette page de config qu'on peut créer les tables.

(...)

l'idée au départ est la suivante:

« On regarde les mots qui sont sélectionné et les choses qui sont sélectionnés:

  • s'il y en a alors on associe/enleve les mots comme il faut et

remplis le tableau $choses des choses sélectionnées

  • s'il y a que des mots sélectionnés, alors on cherche comme il

faut les choses à afficher en fonction des mots choisis/exclus et on remplit le tableau $choses avec

  • s'il n'y a que des choses sélectionnés, alors on remplis $choses

de ces choses (ce qui permet de limiter le nombre de choses affichées et de changer la "coloration" des mots pour voir ceux qui sont associés seulement à ces choses là)

  • s'il n'y a rien de sélectionnés, on remplit le tableau avec

toutes les choses possibles

Last modified 12 years ago Last modified on Oct 18, 2006, 2:52:43 PM