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)
- Télécharger l'extension Tags
- Les décompresser et les copier dans le répertoire tools de votre YesWiki
- Ajouter dans une page de votre YesWiki l'action correspondante entre {{ }}
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 {{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
{{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"}}
Action listepages : N'existe pas
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
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 ...}} : l'action est réservée au groupe des administrateurs...
Les handlers
/ajaxaddcomment, /ajaxdeletepage, /ajaxeditsont 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.phpligne:
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