- Le panneau d'administration du widget
- Les classes utilisées pour les CSS
- Balises, codes et paramètres de mise en forme
- Utilisation avec <tpl:Widget>
- Les fonctions intOtherBlog et extOtherBlog
- Historique des versions
Les informations données ici correspondent à la version la plus récente d'OtherBlog. 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.
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 :
- le formatage de la date est décrit plus bas.
- le paramétrage de %TEXT% est décrit plus bas.
- 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=[…]
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.
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.