Extension Tags


Ensemble d'actions permettant d'associer a des pages wiki des mot clés, afin de catégoriser le contenu.

Attention : ne marche qu'en PHP5.

Installation


ATTENTION : cette extension est en cours de développement, elle fonctionne uniquement avec la dernière version de YesWiki (bachibouzouk)


Fonctionnement des tags

En mode édition, noter des mot-clés, séparés par un espace, dans la zone de saisie prévue à cet effet en bas de page.
Attention : pas d'apostrophes !

On peut ensuite afficher les pages taguées de différentes façons grâce aux actions suivantes

Les actions utilisateurs


L'action {{microblog}}

Affiche un microblog sur la page, avec la liste des derniers billets, et un flux rss associé
Paramètres
  • tags : mots-clés utiliser automatiquement pour les billets du mini-blog
  • edit : possibilité d'éditer les billets au survol, par défaut c'est oui
  • class : associe une classe css aux pages (valeur "microblog" par défaut)
  • enhaut : si "oui" le formulaire des microblog apparait en haut, autre valeur : apparait en bas. "oui" par défaut
  • tri : trie par ordre alphabétique ("alpha") ou chronologique ("date")
  • nb : nombre maximum de pages affichées sur une même page (si pas de valeur : affiche toutes les pages).
  • nbcar : nombre maximum de caractères par billet de microblog
  • pageformulaire : nom de la page wiki qui contient le formulaire microblog (très optionnel)
  • template : permet de définir l'affichage du microblog, par exemple simple c'est sans la barre des tags.

Exemple : {{microblog tags="actu" edit="1" template="formulaire_microblog_simple.tpl.html"}} donne {{microblog tags="actu" edit="1" template="formulaire_microblog_simple.tpl.html"}}


L'action {{nuagetag}}

Affiche un nuage de mots clé, avec 6 niveaux de tailles de mot clés en fonction de leur fréquence d'utilisation.
Paramètres
  • tri : mettre "alpha" pour avoir un tri alphabétique, il sera mélangé aléatoirement sinon
Exemple :
{{nuagetag tri="1"}} donne

{{nuagetag tri="alpha"}} donne


L'action {{listepages}}

L'action {{listepages}} permet de faire s'afficher les pages taguées. Par défaut, tout le contenu de la page s'affiche, mais on peut modifier ce paramètre.
Paramètres
  • tags (obligatoire) : ensemble des mots-clés devant figurer dans les pages
  • notags : ensemble des mots-clés ne devant pas figurer dans les pages
  • edit : possibilité d'éditer les pages
  • class : associe une classe css aux pages (valeur "liste" par défaut)
  • tri : trie par ordre alphabétique ("alpha") ou chronologique ("date")
  • nb : nombre maximum de pages affichées sur une même page (si pas de valeur : affiche toutes les pages).
  • vue : indique le template à utiliser {{listepages tags="actu" vue="bulle_microblog.tpl.html"}}
Exemple : {{listepages tags="utilisateur" accordeon="1"}} donne
Action listepages : NOT_FOUND

L'action {{rss}}

Génère un flux RSS avec possibilité de sélectionner l'ensemble des pages contenant certains tags choisis.
Paramètres
  • tags (obligatoire) : ensemble des mots clés devant figurer dans le flux rss
  • notags : ensemble des mots clés ne devant pas figurer dans le flux rss
  • nbcar : nombre de caractères maximum de la page a afficher dans le flux rss
Attention : ne pas mettre le flux RSS d'un tag dans une page qui est elle-même taguée par ce mot-clé !
Exemple : {{rss tags="miniblog" nbcar="200"}} donne :

Les actions réservées au groupe d'administrateurs


L'action {{admintag}}

Affiche la liste complète des tags utilisés, avec les pages associées, en offrant la possibilité de les supprimer massivement.
Attention : il faut être identifié comme administrateur du Wikini
Exemple : {{admintag}} donne
Action {{admintags ...}} : this action is for the admins only...

Les handlers

/ajaxaddcomment, /ajaxdeletepage, /ajaxedit
sont les équivalent ajax (donc renvoyant du json plutôt que du html) des handlers /addcomment, /deletepage, /edit


Les parametres de configuration

Dans le dossier tools/tags/wiki.php

ligne:
define('COMMENTAIRES_OUVERTS_PAR_DEFAUT', 1);
> pour afficher par défaut la possibilité d'ajouter des commentaires à une page (on peut toujours affine page par page par la suite)


define('CACHER_MOTS_CLES', 0);
> pour qu'en mode édition n'apparaissent pas les mots clés à saisir

Observations

Lorsqu'on édite une page pour modifier un tag (on touche uniquement au tag et pas au contenu de la page), puis qu'on sauvegarde la page, la boite de dialogue Cette page n'a pas été enregistrée car elle n'a subi aucune modification apparaît.
Voilà une action qui demande un clic supplémentaire...

documentation