Page mise à jour le 03/08/2013

Formatage des items :

A partir de la v1.7.0, de nouvelles balises, plus lisibles, sont mise à disposition pour formater les items. Les anciennes balises restent disponibles pour des raisons de compatibilité mais il est conseillé de ne plus les utiliser.

Les balises suivantes sont utilisées pour spécifier l'agencement (disposition et contenu) de chaque item de la liste :

old new permet d'afficher...
%_D%(1) %date%(1) date/heure de publication du billet
sans lien ni balisage Html
%D%(1) %DATE%(1) date/heure de publication du billet
%DB%(1) %DATE:BLOG%(1) date/heure de publication du billet
en tant que lien vers le blog
%DT%(1) %DATE:POST% date/heure de publication du billet
en tant que lien vers le billet
%_B% %blog% le nom du blog sans lien ni balisage Html
%b% %BLOG% le nom du blog sans lien
%B% %BLOG:BLOG% le nom du blog en tant que lien vers le blog
%BT% %BLOG:POST% le nom du blog en tant que lien vers le billet
%_T% %title% le titre du billet sans lien ni balisage Html
%t% %TITLE% le titre du billet sans lien
%T% %TITLE:POST% le titre du billet en tant que lien vers le billet
%TB% %TITLE:BLOG% le titre du billet en tant que lien vers le blog
%_R% %nbcomm% le nombre de commentaires (réactions)
du billet sans lien ni balisage Html
%r% %NBCOMM% le nombre de commentaires du billet sans lien
%R% %NBCOMM:COMM% le nombre de commentaires du billet
en tant que lien vers les commentaires du billet
%_P% %nbping% le nombre de rétroliens (pings) du billet
sans lien ni balisage Html
%p% %NBPING% le nombre de rétroliens du billet sans lien
%P% %NBPING:PING% le nombre de rétroliens du billet
en tant que lien vers les rétroliens du billet
%E% %E% l'extrait (si présent)
%C% %C% le contenu du billet
%EC% %EC% l'extrait (si présent)
sinon affiche le contenu du billet
  %TEXT%(2) affiche tout ou partie du texte du billet
  %IMAGE%(3) affiche des images trouvées dans le billet

Notes :

  1. le formatage de la date est décrit plus bas.
  2. le paramétrage de %TEXT% est décrit plus bas.
  3. le paramétrage de %IMAGE% est décrit plus bas.

Ces codes sont facultatifs et peuvent être mis dans l'ordre où vous le souhaitez. Si un code est absent, alors le champ correspondant ne sera pas affiché.

Vous pouvez insérer des espaces, un caractères et/ou du texte entre chaque code de formatage.

Remarque concernant l'utilisation de %E%, %C% et %EC% : extraits et contenus des billets ne font l'objet d'aucun traitement particulier. Donc...

  • les balises HTML qu'ils contiennent restent en l'état,
  • ils conservent le jeu de caractères utilisé par Dotclear,
  • l'URL des images ne change pas. Notamment les images dont l'URL est relative : dans certains cas il est possible qu'elles ne puissent s'afficher.

Paramétrage de %TEXT% :

Les codes suivants sont utilisés pour paramétrer l'extraction du texte :

  • from : provenance du texte
    valeurs possibles : excerpt (chapo), content (contenu), full (tout le billet), first (chapo si présent, contenu sinon)
    valeur par défaut : full.
  • length : longueur maxi du texte à extraire
    valeurs possibles : 0 à n
    valeur par défaut : 100
    si length = 0 ou si length > longueur du texte, extraction de tout le texte.
  • cut : texte qui sera affiché à la suite du texte si celui a été tronqué
    valeur par défaut : […] qui s'affichera […].

Remarques :

  • le texte sera débarrassé de toutes les balises HTML (comme <p>, <img>, <div>, etc...) avant d'être tronqué et affiché.
  • compte-tenu de la présence possible de caractères spéciaux dans le texte à tronquer et compte-tenu du fait que la coupure respecte les mots, le résultat du raccourcissement peut être inférieur à la valeur de "length".

Par défaut :

from=full, length=100, cut=[&hellip;]

Paramétrage de %IMAGE% :

Les codes suivants sont utilisés pour paramétrer l'extraction des images :

  • link : cible du lien posé sur chaque image
    valeurs possibles : entry (billet), none (aucun lien)
    valeur par défaut : none.
  • from : provenance des images
    valeurs possibles : excerpt (chapo), content (contenu), full (tout le billet), first (chapo si présent, contenu sinon)
    valeur par défaut : full.
  • start : rang de la première image à extraire
    valeurs possibles : 1 à n
    valeur par défaut : 1
    si start < 1 ou start > nombre total d'images dans le billet, aucune image n'est extraite.
  • length : nombre d'images à extraire
    valeurs possibles : 0 à n
    valeur par défaut : 1
    si length = 0 ou si length > nombre total d'images du billet, extraction de toutes les images).
  • size : taille des images affichées
    si size est absent : pas de modification de la taille, sinon, peut prendre une des valeurs
    • sq (square) = image carrée (toujours 48x48 pixels).
    • t (thumbnail) = miniature (par défaut = 100 pixels).
    • s (small) = petite (par défaut = 240 pixels).
    • m (medium) = moyenne (par défaut = 448 pixels).
    • o (originale) = correspond à l'image téléchargée.
    Le format demandé doit être présent dans le gestionnaire de médias du blog concerné. Les dimensions par défaut données ici sont celles fournies par un Dotclear non personnalisé et correspondent au plus grand côté.

Par défaut :

link=none, from=full, start=1, length=1

Formatage de la partie date/heure :

Les principaux codes utilisés pour spécifier le format de la date sont :

  • %a - nom abrégé du jour de la semaine (local)
  • %A - nom complet du jour de la semaine (local)
  • %b - nom abrégé du mois (local)
  • %B - nom complet du mois (local)
  • %C - numéro de siècle (entre 00 et 99)
  • %d - jour du mois en numérique (intervalle 01 à 31)
  • %D - identique à %m/%d/%y
  • %e - numéro du jour du mois (de ' 1' à '31')
  • %g - identique à %G, sur 2 chiffres
  • %H - heure de la journée sur 24-heures (00 à 23)
  • %I - heure de la journée sur 12-heures (01 à 12)
  • %j - jour de l'année (01 à 366)
  • %m - mois(intervalle 1 à 12)
  • %M - minute en numérique
  • %r - l'heure au format a.m. et p.m
  • %R - l'heure au format 24h
  • %S - secondes en numérique
  • %u - le numéro de jour dans la semaine, de 1 à 7. (1 = Lundi)
  • %U - numéro de semaine dans l'année,
    (1er dimanche de l'année = 1er jour de la 1ère semaine)
  • %W - numéro de semaine dans l'année,
    (1er lundi de l'année = 1er jour de la 1ère semaine)
  • %w - jour de la semaine, numérique (Dimanche = 0)
  • %y - l'année sur deux chiffres (de 00 à 99)
  • %Y - l'année sur quatre chiffres
  • %Z ou %z - fuseau horaire, ou nom ou abréviation

(Source : doc PHP en ligne - liste complète : ici)

Exemple :

"Le %d/%m/%Y à %Hh%M"

Localisation de la date :

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

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 le champ "setlocal" :

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