Page mise à jour le 15/12/2017

A partir de la v2.1 de Dotclear et de la v1.4.2 d'OtherBlog, vous pouvez ajouter directement le widget dans les templates de votre thème, à l'aide du marqueur de template <tpl:Widget>. Remarque : ce marqueur remplace {{tpl:ListNewPostOtherBlog}} qui n'est plus proposé par OtherBlog depuis sa v1.5.5.

Liste des paramètres acceptés par <tpl:Widget id="mrvbOtherBlog">.

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...

  • title (text) :
    titre du bloc affichant la liste.
    Par défaut : [In other blogs/Dans les autres blogs].
  • CSSclass (text) :
    Classe CSS facultative permettant de styler différemment plusieurs instances du widget.
    Par défaut : [vide].
  • homeonly (0|1) :
    indique si la liste des billets ne sera affichée qu'en page d'accueil ou sur toutes les pages.
    Par défaut : [0] (toutes les pages).
  • offline (0|1) :
    permet de désactiver l'affichage de la liste des billets.
    Par défaut : [0] (liste affichée).
  • blogid (text) :
    identifiant(s) du/des blog(s) (séparés par une virgule).
    • Si absent : tous les blogs sont pris en compte,
    • La virgule "," sert de séparateur entre chaque élément de la liste,
    • le caractère "!" devant l'identifiant d'un blog l'exclut du listage.
    Par défaut : [vide] (tous les blogs).
  • category (text) :
    Liste des catégories servant de filtre pour le listage des billets.
    • Si absent : toutes les catégories sont prises en compte,
    • si vaut NULL : seuls les billets sans catégorie seront retenus.
    • La virgule "," sert de séparateur entre chaque élément de la liste,
    • le caractère "!" devant le nom d'une catégorie l'exclut du listage.
    Deux notations sont acceptées :
    • nom URLisé : attention à bien respecter la casse du nom.
    • n° d'ID : sera alors précédé du caractère "#".
    Par défaut : [vide] (toutes les billets, y compris ceux sans catégorie).
  • metatag (text) :
    mot-clé permettant de n'afficher que les billets qui ont ce mot-clé.
    Par défaut : [vide] (pas de filtrage).
  • selected (0|1) :
    permet de ne retenir que les billets ayant le statut "sélectionné".
    Par défaut : [0] (pas de filtrage).
  • password (no|also|only) :
    mise en place d'un filtre sur les billets avec ou sans protection par mot de passe
    • si "only" : seuls les billets avec mot de passe sont listés,
    • si "also" : les billets avec mot de passe sont inclus dans la liste,
    • sinon : les billets avec mot de passe ne sont pas listés.
    Par défaut : [vide] (pas de listage des billets ayant un mot de passe).
  • listurl (text) :
    filtre sur une liste de billets (chaque billet désigné par son url locale)
    • une ou plusieurs url placées entre '' et séparées par des virgules,
    • si vide alors pas de filtre,
    Par défaut : [vide] (pas de filtrage).
  • typepost (text) :
    précise le type de billet à lister et le type d'URL pour appeler ce type de billet
    • format 'typ/url' avec un slash comme séparateur
    • si url absent alors url = typ
    • si vide, est équivalent à 'post/post'
  • maxitems (text) :
    nombre maximum de billets à lister
    • si [vide], alors pas de limite,
    • si [x-y], alors "x" billets après les "y" plus récents.
    Par défaut : [8].
  • orderby (asc|desc) :
    ordre de listage des billets : 'asc' (plus ancien en premier) ou 'desc' (plus récent en premier).
    si absent ou différent de 'asc'/'desc' alors orderby = 'desc'.
  • typlist (ul|div|) :
    type de format de la liste :
    • si 'ul' : liste à puce (<ul><li>)
    • si 'div' : bloc <div>
    • si '' : aucun format ne sera appliqué
  • formdate (text) :
    formatage de la date.
    Par défaut : [%d/%m/%Y %Hh%M].
    Se reporter à cette page pour la syntaxe à utiliser.
  • setlocal (text) :
    localisation du format de la date. Une ou plusieurs valeurs séparées par des virgules, par défaut : [vide].
    (plus d'infos en bas de page)
  • titlemax (text) :
    longueur maximum de chaque titre de billet.
    La longueur réelle dépendra des mots utilisés car aucun d'entre eux ne sera tronqué.
    Par défaut : [0] (pas de troncature).
  • settext (text)
    paramétrage de %TEXT%.
    Par défaut : [from=full, length=100, cut=[&hellip;]].
    Se reporter à cette page pour la syntaxe à utiliser.
  • setimage (text)
    paramétrage de %IMAGE%.
    Par défaut : [link=none, from=full, start=1, length=1].
    Se reporter à cette page pour la syntaxe à utiliser.
  • formitem (text) :
    formatage de chaque item.
    Par défaut : [%DATE% : %BLOG:BLOG% - %TITLE:POST%]
    (correspond à l'ancienne notation [%D% : %B% - %T%]
    .
    Se reporter à cette page pour la syntaxe à utiliser.
  • titlecut (text) :
    texte indiquant que le titre du billet a été tronqué.
    Ne sera affiché que si le titre est réellement tronqué.
    Par défaut : [[&hellip;]].
  • noexcerpt (text) :
    affiche un texte de remplacement si l'extrait est vide
    par défaut : [vide].
  • readmore (text)
    texte invitant à lire la suite du billet.
    Sera affiché après l'extrait si l'extrait existe et si le contenu du billet n'est pas demandé dans la chaîne de formatage.
    Par défaut : [vide].
  • intro (text) :
    chaîne de caractères qui servira d'introduction à la liste.
    Par défaut : [vide].
  • conclu (text)
    chaîne de caractères qui servira de conclusion à la liste.
    Par défaut : [vide].

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

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

Depuis la v1.6.1 d'OtherBlog le paramètre homeonly voit sa valeur par défaut inversée par rapport aux versions antérieures (affichage dans toutes les pages au lieu de affichage uniquement en page d'accueil).

Exemple (affichage uniquement en page d'accueil) :

<tpl:Widget id="mrvbOtherBlog">
  <setting name="blogid">default</setting>
  <setting name="maxitems">12</setting>
  <setting name="formitem">%D% : %T%</setting>
  <setting name="homeonly">1</setting>
</tpl:Widget>

Si vous ne souhaitez pas afficher le titre, vous devez mettre :

<setting name="title"></setting>

A propos de setlocal :

Sont principalement impactés par le contenu de "setlocal" les formats de date %a, %A, %b et %B. Ce contenu correspond à celui utilisé par la fonction 'setlocale' du langage PHP. Son rendu dépendra du système d'exploitation du serveur web. Plusieurs valeurs peuvent être saisies, séparées par des virgules.

Exemple :

Supposons que setlocal vaut 'fra, fr_FR, toto, english'. Si le serveur ne reconnaît pas 'fra', alors il essaye de prendre en compte 'fr-FR', si 'fr-FR' lui est inconnu, alors... etc...

Quelques termes acceptés tant par Windows que par Linux pour <setting name="setlocal">[####]</setting> où [####] sera remplacé par...

  • french pour le français,
  • german pour l'allemand,
  • english pour l'anglais,
  • spanish pour l'espagnol,
  • italian pour l'italien.

Pour plus d'infos, je vous invite à consulter la doc PHP (fonction 'setlocale'), la norme ISO639 et la liste des codes reconnus par Windows.