Page mise à jour le 26/06/2017

Les informations données ici correspondent à la version la plus récente de mrvbNextDoor. Si vous utilisez une version plus ancienne, veuillez vous reporter au fichier "lisezmoi.txt" fourni avec votre version et installé dans le répertoire du plugin.

Classes fournies par le widget :

Ces classes et l'organisation du code Html fourni par le widget dépendent du type de liste choisie. La signification des [###], [&&&] et [$$$] présents dans les différents cas d'utilisation est précisée dans le paragraphe "Conventions et remarques".

  1. cas d'une utilisation avec liste de type "liste à puces" (typlist = "ul") :
    <div class="mrvbNextDoor [###]">
        <h#>Titre du widget</h#>
        <div class="nxdo-first">Texte d'introduction</div>
        <ul class="nxdo-list">
          <li class="nxdo-item [&&&]">
              [$$$]
          </li>
          <li class="nxdo-item [&&&]">
              [$$$]
          </li>
          (etc...)
        </ul>
        <div class="nxdo-last">Texte de conclusion</div>
    </div>
    
  2. cas d'une utilisation avec liste de type "bloc div" (typlist = "div") :
    <div class="mrvbNextDoor [###]">
        <h#>Titre du widget</h#>
        <div class="nxdo-first">Texte d'introduction</div>
        <div class="nxdo-item [&&&]">
            [$$$]
        </div>
        <div class="nxdo-item [&&&]">
            [$$$]
        </div>
        (etc...)
        <div class="nxdo-last">Texte de conclusion</div>
    </div>
    
  3. cas d'une utilisation sans liste (typlist = "") :
    <div class="mrvbNextDoor [###]">
        <h#>Titre du widget</h#>
        <div class="nxdo-first">Texte d'introduction</div>
          [$$$][$$$] (etc...)
        <div class="nxdo-last">Texte de conclusion</div>
      </div>
    </div>
    

Conventions et remarques :

  • [###] : Vous pouvez ajouter une classe, ici symbolisée par [###], via le panneau d'administration du widget permettant ainsi de styler différemment plusieurs instances du widget.
  • [&&&] : ajout à la classe "nxdo-item" des classes suivantes :
    • blog-? (où "?" est remplacé par l'ID du blog auquel appartient l'item),
    • cat-? (où "?" est remplacé par l'ID de la catégorie) si l'item a une catégorie,
    • nocat si l'item n'a pas de catégorie,
    • nxdo-pwd si et seulement si l'item a un mot de passe.
  • [$$$] : chaque item de la liste est symbolisé ici par [$$$].
  • L'introduction est un <div class="nxdo-first"> (pas de balise si pas de texte).
  • La conclusion est un <div class="nxdo-last"> (pas de balise si pas de texte).
  • <h#> : à partir de la v1.8.7, la balise encadrant le titre (marquée ici <h#>) peut changer selon de jeu de template du thème utilisé :
    • si 'tplset' => 'currywurst' alors le titre du widget sera entre <h3> et </h3>,
    • sinon le titre reste comme précédemment entre <h2> et </h2>.
    • la classe "nxdo-title" est supprimée.

Classes fournies par les fonctions intmrvbNextDoor ou extmrvbNextDoor :

  • Utilisation avec nolist="0" (par défaut) :
    <ul class="nxdo-list">
      <li class="nxdo-item [&&&]">
          [$$$]
      </li>
    </ul>
    
  • Utilisation avec nolist="1" :
    ne reste donc qu'une série de [$$$]

Même remarques et conventions que pour le widget.

Classes fournies pour chaque item de la liste :

Le contenu de [$$$] dépendra des codes de formatage suivants :

  • %date%
    date/heure
  • %DATE%
    <span class="nxdo-date">date/heure</span>
  • %DATE:BLOG%
    <a class="nxdo-datelink" href="[URL du blog]">date/heure</a>
  • %DATE:POST%
    <a class="nxdo-datelink" href="[URL du billet]">date/heure</a>

  • %blog%
    Nom du blog
  • %BLOG%
    <span class="nxdo-blog">Nom du blog</span>
  • %BLOG:BLOG%
    <a class="nxdo-bloglink" href="[URL du blog]">Nom du blog</a>
  • %BLOG:POST%
    <a class="nxdo-bloglink" href="[URL du billet]">Nom du blog</a>

  • %title%
    Titre du billet
  • %TITLE%
    <span class="nxdo-post">Titre du billet</span>
  • %TITLE:POST%
    <a class="nxdo-postlink" href="[URL du billet]">Titre du billet</a>
  • %TITLE:BLOG%
    <a class="nxdo-postlink" href="[URL du blog]">Titre du billet</a>

  • %nbcomm%
    nombre de commentaires du billet
  • %NBCOMM%
    <span class="nxdo-comments">nombre de commentaires du billet</span>
  • %NBCOMM:COMM%
    <a class="nxdo-comments" href="[URL du billet#comments]">nombre de commentaires du billet</a>
  • %nbcomm[]%
    nombre de commentaires du billet formaté par "setnbcomm"
  • %NBCOMM[]%
    <span class="nxdo-comments">nombre de commentaires du billet formaté par "setnbcomm"</span>
  • %NBCOMM:COMM[]%
    <a class="nxdo-comments" href="[URL du billet#comments]">nombre de commentaires du billet formaté par "setnbcomm"</a>

  • %nbping%
    nombre de rétroliens du billet
  • %NBPING%
    <span class="nxdo-pings">Nombre de rétroliens du billet</span>
  • %NBPING:PING%
    <a class="nxdo-pings" href="[URL du billet#pings]">Nombre de rétroliens du billet</a>

  • %catname[xyz]%
    xyz + nom de la catégorie
  • %CATNAME[xyz]%
    xyz + <span class="nxdo-cat">nom de la catégorie</span>
  • %CATNAME:CAT[xyz]%
    xyz + <a class="nxdo-cat" href="[URL de la catégorie]">nom de la catégorie</a>

  • %E%(1)
    <div class="nxdo-excerpt">extrait</div>
  • %E%(2)
    <div class="nxdo-excerpt">extrait<p class="nxdo-readmore"><a href="[URL du billet]">lire la suite</a></p></div>
  • %C%
    <div class="nxdo-content">contenu</div>
  • %EC%(*)
    <div class="nxdo-content">extrait/contenu</div>

  • %TEXT%
    contenu
  • %IMAGE%(1)
    <img class="nxdo-img" />
  • %IMAGE%(2)
    <a class="nxdo-postlink" href="[URL billet]"><img class="nxdo-img" /></a>

  • %LINK:BLOG[xyz]%
    <a class="nxdo-bloglink" href="[URL du blog]" title="[titre du blog]">xyz</a>
  • %link:BLOG[xyz]%
    <a class="nxdo-bloglink" href="[URL du blog]">xyz</a>

  • %LINK:POST[xyz]%
    <a class="nxdo-postlink" href="[URL du billet]" title="[titre du billet]">xyz</a>
  • %link:POST[xyz]%
    <a class="nxdo-postlink" href="[URL du billet]">xyz</a>

  • %LINK:COMM[xyz]%
    <a class="nxdo-comments" href="[URL du billet#comments]" title="[titre du billet]">xyz</a>
  • %link:COMM[xyz]%
    <a class="nxdo-comments" href="[URL du billet#comments]">xyz</a>

  • %LINK:PING[xyz]%
    <a class="nxdo-pings" href="[URL du billet#pings]" title="[titre du billet]">xyz</a>
  • %link:PING[xyz]%
    <a class="nxdo-pings" href="[URL du billet#pings]">xyz</a>

Remarques :

  • %E%(1) : cas où il n'y a pas d'invite pour lire la suite.
  • %E%(2) : cas où il y a invite pour lire la suite.
  • %EC%(*) : extrait (si présent) ou contenu (sinon).
  • %IMAGE%(1) : cas où il n'y a pas de lien vers le billet.
  • %IMAGE%(2) : cas où il y a un lien vers le billet.