Page mise à jour le 02/09/2018

Retour au billet

Le widget :

  • Titre du widget (optionnel).
  • Affiche le nombre de billets de chaque catégorie
    • "Jamais" (par défaut),
    • "Après chaque item",
    • "Dans une info-bulle".
  • Permet de n'afficher que les x premiers niveaux de l'arborescence (le champ vide ou contenant le chiffre "0" signifie "tous")
  • Prend en compte (ou pas, par défaut) le nombre de billets des sous-catégories.
  • Permet l'exclusion d'une ou plusieurs catégories (ID séparés par "," ou par un saut de ligne) de la liste.
  • Liste affichant les catégories du blog ainsi que leur ID. Ceci est une aide au paramétrage sans impact sur l'affichage du widget. Ici, "Exergue (ID=35)" est à considérer comme un exemple d'affichage.
  • "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 "mrvbsubcategories", de la classe "widget" et de la classe personnalisée (facultative) dans le conteneur principal <div class="categories">,
  • chaque item de la liste a une classe <li class="catXXX"> où XXX est l'id de la catégorie,
  • dans le contexte d'affichage d'un billet, la classe de l'item correspondant à la catégorie du billet est <li class="catXXX category-current">.

Utilisation avec <tpl:Widget>

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

<tpl:Widget id="mrvbSubCategories">
  <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 : [Catégories].
  • showcount (shownever|showafter|showballoon) :
    affiche (ou pas : shownever) dans une info-bulle (showballoon) ou entre parenthèses (showafter) le nombre de billets de la catégorie.
    Par défaut : [shownever] (Jamais).
  • maxlevel (nombre) :
    n'affiche que les "x" premiers niveaux de l'arborescence
    Par défaut : [vide] (tous les niveaux)
  • countsubcat (0|1) :
    prend en compte (ou pas) le nombre de billets des sous-catégories.
    Par défaut : [0] (pas de prise en compte).
  • excludeID (text) :
    exclut une ou plusieurs catégories (ID séparés par ",") de la liste.
    Par défaut : [vide] (aucune exclusion).
  • helpcatID (list) :
    aide au paramétrage du widget. Aucun impact sur son affichage.
  • 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].

Remarques :

  1. La possibilité d'exclure plusieurs catégories sous forme de liste d'URL séparées par "/" a été supprimée.
  2. Jusqu'à la v0.3.2, la classe CSS supplémentaire était "mysubcategories". A partir de la v0.3.3, cette classe devient "mrvbsubcategories". A partir de la v0.3.4, l'ancienne classe "mysubcategories" est supprimée.
  3. Jusqu'à la v0.2.9 de mrvbCustomWidgets, le choix d'afficher (ou pas) le nombre de billets s'effectuait via une case à cocher. A partir de la v0.3.0a, ce choix se fait via un menu déroulant proposant 3 options :
    • "jamais" (par défaut),
    • "après chaque item",
    • "dans une info-bulle".
    Si vous effectuez une mise à jour depuis la v0.2.9 (ou antérieure) vers la v0.3.0 (ou postérieure) et si vous souhaitez l'affichage du nombre de billets, pensez à revalider votre choix dans l'administration du widget mrvbCategories.