Page mise à jour le 02/09/2018

Retour au billet

Le widget :

  • Titre du widget (optionnel).
  • Si "billets sélectionnés uniquement" est coché, seul les billets ayant le statut "sélectionné" seront affichés.
  • Le champ "filtre sur un type ou une liste de types" (séparés par des virgules) permet de n'afficher que les billets ayant ce(s) type(s)(si vide = post).
  • Si le champ "Catégorie" contient le nom d'une catégorie choisie dans la liste, seuls les billets appartenant à cette catégorie seront affichés. (par défaut, vide = pas de filtre).
  • Le champ "Catégories à exclure" permet l'exclusion d'une ou plusieurs catégories (ID séparés par "," ou par un saut de ligne) de la liste. Pris en compte uniquement si aucune catégorie n'est sélectionnée dans le champ "Catégorie".
  • Si le champ "Mot-clé" contient un mot-clé, seuls les billets ayant ce mot-clé seront affichés (par défaut, vide = pas de filtre).
  • Nombre maxi de billets affichés.
  • "Afficher" propose 3 options pour afficher le widget en fonction du contexte :
    • "Sur toutes les pages",
    • "En page d'accueil uniquement" (par défaut),
    • "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 "mrvblastposts", de la classe "widget" et de la classe personnalisée (facultative) dans le conteneur principal <div class="lastposts">,

Utilisation avec <tpl:Widget>

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

<tpl:Widget id="mrvbLastPosts">
  <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 : [Derniers billets].
  • selected (0|1) :
    permet de ne lister que les billets sélectionnés. Par défaut : [0] (tous).
  • typepost (text) :
    permet de ne lister que les billets ayant e(s) type(s) indiqués. Plusieurs types sont possibles : liste utilisant la virgule comme séparateur. Par défaut : [] (post).
  • category (text) :
    liste permettant de choisir entre "" (quelque soit la catégorie), "sans catégorie" (billet sans catégorie) ou une parmi celles listée.
    Par défaut : [vide] (quelque soit la catégorie).
  • excludeID (text) :
    exclut une ou plusieurs catégories (ID séparés par ",") si et seulement si category = "" (quelque soit la catégorie).
    Par défaut : [vide] (aucune exclusion).
  • tag (text) :
    filtre sur un mot-clé.
    Par défaut : [vide] (quelque soit le mot-clé)
  • limit (text) :
    Nombre de billets maximum (0 = tous).
    Par défaut : [10] (les 10 derniers billets) :
  • 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 : [1] (page d'accueil uniquement).
  • 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].