Page mise à jour le 15/12/2017

Retour au billet

Utilisation avec <tpl:Widget>

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

<tpl:Widget id="mrvbToC">
  <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 : [Table des matières].
  • count (0|1) :
    permet d'afficher le nombre de billets.
    Par défaut : [0] (non coché).
  • nopassword (0|1) :
    permet de ne lister que les billets n'ayant pas de mot de passe.
    Par défaut : [0] (non coché).
  • selected (0|1) :
    permet de ne lister que les pages marquées comme visibles pour leur widget associé (widget "Pages" / widget "Pages connexes").
    Par défaut : [0] (non coché).
  • sortby (date-asc, date-desc, title) :
    ordre de tri des billets
    • si date-asc = par ordre chronologique des dates de publication,
    • si date-desc = par ordre chronologique inverse des dates de publication,
    • si title = par ordre alphabétique des titres des billets.
    Par défaut : [date-asc].
  • titleposts (text) :
    titre de la liste des billets.
    Par défaut : [Liste des billets].
  • post (0|1) :
    permet d'afficher ou pas la liste des billets
    Par défaut : [1].
  • nocategory (0|1) :
    permet de ne lister que les billets avec catégories.
    Par défaut : [0] (non coché).
  • hideposts (0|1) :
    permet d'activer le javascript pour cacher/montrer la liste des billets avec catégories
    Par défaut : [0] (tous les billets avec catégories sont affichés).
  • titlepages (text) :
    titre de la liste des pages.
    Par défaut : [Liste des pages].
  • page (0|1) :
    permet d'afficher ou pas la liste des pages créées avec le plugin "Pages"
    Par défaut : [0] (n'affiche pas les pages).
  • position (0|1) :
    permet de forcer l'affichage des pages selon leur position (ordre croissant)
    Par défaut : [0] (non coché).
  • hidepages (0|1) :
    permet d'activer le javascript pour cacher/montrer la liste des pages
    Par défaut : [0] (toutes les pages sont affichées).
  • titlestatics (text) :
    titre de la liste des pages statiques.
    Par défaut : [pages statiques].
  • static (0|1) :
    permet d'afficher ou pas la liste des pages statiques créées avec le plugin "Related Pages"
    Par défaut : [0] (n'affiche pas les pages statiques).
  • hidestatics (0|1) :
    permet d'activer le javascript pour cacher/montrer la liste des pages statiques
    Par défaut : [0] (script inactif, toutes les pages statiques sont affichées).
  • more (text) :
    texte du lien utilisé pour déplier la liste
    Par défaut : [▼].
  • less (text) :
    texte du lien utilisé pour replier la liste
    Par défaut : [▲].
  • 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].
  • offline (0|1) :
    permet de désactiver l'affichage du widget.
    Par défaut : [0] (widget affiché).

Remarques :

A partir de la version 0.3.3, le paramètre script est remplacé par les paramètres hideposts, hidepages et hidestatics permettant ainsi de mieux cibler le champ d'action du javascript.

A partir de la version 0.3.5, les paramètres post, pages et static qui étaient précédemment des champs [text] deviennent des cases à cocher [0|1].

Information complémentaire :

Concernant le marquage d'une page ou d'une page statique pour être affichée par leur widget, ce marquage se fait actuellement via la case à cocher "Ne pas lister dans le widget Pages" de l'écran d'édition d'une page faite avec le plugin "Pages" et la case à cocher proposée dans la liste "Ordonner la liste publique", colonne "Page visible dans le widget" du plugin "Pages connexes"