Page mise à jour le 02/09/2018

Retour au billet

Le widget :

  • Titre du widget (optionnel).
  • Nombre maxi de mots-clés affichés (20 par défaut, vide = tous).
  • Affiche le nombre de billets pour chaque mot-clé
    • "Jamais" (par défaut),
    • "Après chaque item",
    • "Dans une info-bulle".
  • Permet l'exclusion d'un ou plusieurs mots-clés séparés par "," ou par un saut de ligne de la liste.
  • Trier par "nom du mot-clé" (par défaut) ou par "nombre de billets".
  • Ordre croissant (par défaut) ou ordre décroissant
  • Permet d'afficher (ou pas) un lien vers le récapitulatif de tous les mots-clés. Lien dans un paragraphe <p classe="goTags">.
  • Liste affichée sous forme de liste à puce (mode par défaut) ou dans un paragraphe.
  • Un ou plusieurs caractères affichés après chaque item dans le cas d'un affichage "paragraphe" (caractère "," par défaut).
  • Un ou plusieurs caractères affichés à la fin de la liste dans le cas d'un affichage "paragraphe" (caractère "." par défaut).
  • "Afficher" propose 3 options pour afficher le widget en fonction du contexte :
    • "Sur toutes les pages" (par défaut),
    • "En page d'accueil uniquement",
    • "Sauf en page d'accueil".
  • Si coché, ce widget ne sera pas inclu dans un bloc <div>...</div> (décoché par défaut).
  • Classe CSS (facultative) si le widget est dans un bloc <div>...</div>.
  • Si coché, ce widget ne sera pas affiché quelque soit le contexte.

Si vous utilisez un éditeur de texte pour la liste d'exclusion (zone de saisie multi-lignes) et un Dotclear dans une version antérieure à la v2.15, il est conseillé d'utiliser l'onglet source pour modifier son contenu.

Classes ajoutées par le widget :

  • si boîte englobante (activée par défaut), alors ajout de la classe "mrvbtags", de la classe "widget" et de la classe personnalisée (facultative) dans le conteneur principal <div class="tags">,
  • ajout de la classe "tag-current" aux mots-clés attribués au billet actuellement affiché (contexte post.html) :
    • si liste : <li class="tag-current">
    • si paragraphe : <a class="tag-current">
  • si affichage dans un paragraphe (<p class="list">) :
    • ajoute un séparateur (<span class="separator">) complété par un espace à la fin de chaque mot-clé,
    • séparateur spécifique (<span class="last-separator">) marquant la fin.
  • si présent, le lien vers le récapitulatif de tous les mots-clés est dans un paragraphe <p classe="goTags">.

Utilisation avec <tpl:Widget>

Pour ajouter un widget dans un fichier de template, le code sera de la forme :

<tpl:Widget id="mrvbTags">
  <setting name="Nom du paramètre">Valeur du paramètre</setting>
  ...
</tpl:Widget>

Nota : pour faciliter la lecture des valeurs par défaut, celles-ci sont notées ici entre crochet et en italique. [vide] = aucun caractère, [ ] = chaîne de caractères formée d'un unique espace... sans les crochets...

Liste des paramètres disponibles :

  • title (text) :
    titre du widget.
    Par défaut : [Mots-clés].
  • limit (text) :
    nombre maximum de mots-clés affichés dans la liste.
    Par défaut : [20] (si vide, tous les mots-clés seront affichés).
  • showcount (shownever|showafter|showballoon) :
    affiche (ou pas : shownever) dans une info-bulle (showballoon) ou entre parenthèses (showafter) le nombre de billets du mot-clé.
    Par défaut : [shownever] (Jamais).
  • exclude (text) :
    exclut un ou plusieurs mots-clés (séparés par ",") de la liste.
    Par défaut : [vide] (aucune exclusion).
  • sortby (meta_id_lower|count) :
    type de tri : ordre alphabétique des mots-clés (meta_id_lower) ou selon le nombre de billets ayant ce mot-clé (count).
    Par défaut : [meta_id_lower].
  • orderby (asc|desc) :
    Ordre de tri croissant (asc) ou décroissant (desc).
    Par défaut : [desc].
  • alltagslinktitle (text) :
    affiche (ou pas, si vide) un lien vers le récapitulatif de tous les mots-clés.
    Par défaut : [Tous les mots-clés].
  • modlist (list|text) :
    affiche sous forme de liste à puce (list) ou dans un paragraphe (text).
    Par défaut : [list].
  • separator (text) :
    séparateur complété par un espace après chaque mot-clé (seulement si modlist = text).
    Par défaut : [,] (virgule).
  • endlist (text) :
    séparateur spécifique marquant la fin (seulement si modlist = text).
    Par défaut : [.] (point).
  • offline (0|1) :
    permet de désactiver l'affichage du widget.
    Par défaut : [0] (widget affiché).
  • homeonly (0|1|2) :
    Options pour afficher le widget en fonction du contexte
    • si 0 = toutes les pages,
    • si 1 = page d'accueil uniquement,
    • si 2 = sauf page d'accueil
    Par défaut : [0] (toutes les pages).
  • content_only (0|1) :
    Par défaut : [0] (non coché).
  • CSSclass (text) :
    Classe CSS (facultative) si le widget est dans un bloc <div>...</div>.
    Par défaut : [vide].

Remarque :

  1. La possibilité d'utiliser également "/" comme séparateur dans la liste des mots-clés à exclure a été supprimée.
  2. Jusqu'à la v0.3.2, la classe CSS supplémentaire était "mytags". A partir de la v0.3.3, cette classe devient "mrvbtags". A partir de la v0.3.4, l'ancienne classe "mytags" est supprimée.