Page mise à jour le 06/11/2017
- 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 intNextDoor et extNextDoor,
- Migration depuis OtherBlog.
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.
Formatage des items :
Variables mises à disposition :
- $blog_id : ID du blog
- $blog_url : URL du blog
- $blog_name : nom du blog
- $post_id : ID du billet
- $user_id : ID de l'auteur du billet
- $post_url : URL du billet
- $post_title : titre du billet
- $post_trunc_title : titre tronqué du billet
- $post_date : date du billet
- $post_lang : langue du billet
- $nb_comment : nombre de commentaires
- $nb_trackback : nombre de rétro-liens
- $txt_nbcomm : nombre de commentaires formaté par "setnbcomm"
- $cat_url : URL de la catégorie
- $cat_title : nom de la catégorie
- $cat_id : ID de la catégorie du billet (si pas de catégorie, remplacé par '0')
Balises pouvant être utilisées pour spécifier l'agencement (disposition et contenu) de chaque item de la liste :
- %date%
affiche date/heure de publication du billet sans lien ni balisage Html - %DATE%
affiche date/heure de publication du billet (formatage : voir chapitre "formdate") - %DATE:BLOG%
affiche date/heure de publication du billet en tant que lien vers le blog - %DATE:POST%
affiche date/heure de publication du billet en tant que lien vers le billet
- %blog%
affiche le nom du blog sans lien ni balisage Html - %BLOG%
affiche le nom du blog sans lien - %BLOG:BLOG%
affiche le nom du blog en tant que lien vers le blog - %BLOG:POST%
affiche le nom du blog en tant que lien vers le billet
- %title%
affiche le titre du billet sans lien ni balisage Html - %TITLE%
affiche le titre du billet sans lien - %TITLE:POST%
affiche le titre du billet en tant que lien vers le billet - %TITLE:BLOG%
affiche le titre du billet en tant que lien vers le blog
- %nbcomm%
affiche le nombre de commentaires du billet sans lien ni balisage Html - %NBCOMM%
affiche le nombre de commentaires du billet sans lien - %NBCOMM:COMM%
affiche le nombre de commentaires du billet en tant que lien vers les commentaires du billet - %nbcomm[]%
affiche le nombre de commentaires du billet (formaté par setnbcomm) sans lien ni balisage Html - %NBCOMM[]%
affiche le nombre de commentaires du billet (formaté par setnbcomm) sans lien - %NBCOMM:COMM[]%
affiche le nombre de commentaires du billet (formaté par setnbcomm) en tant que lien vers les commentaires du billet
- %nbping%
affiche le nombre de rétro-liens (pings) du billet sans lien ni balisage Html - %NBPING%
affiche le nombre de rétro-liens du billet sans lien - %NBPING:PING%
affiche le nombre de rétro-liens du billet en tant que lien vers les rétro-liens du billet
- %catname[xyz]%
affiche la chaîne "xyz" suivie du nom de la catégorie du billet sans lien ni balisage Html - %CATNAME[xyz]%
affiche la chaîne "xyz" suivie du nom de la catégorie du billet sans lien - %CATNAME:CAT[xyz]%
affiche la chaîne "xyz" suivie du nom de la catégorie du billet en tant que lien vers la liste des billets ayant cette catégorie
- %E%
affiche l'extrait (si présent) - %C%
affiche le contenu du billet - %EC%
affiche l'extrait (si présent) sinon affiche le contenu du billet
- %TEXT%
affiche tout ou partie du texte du billet, nettoyé de toutes les balises HTML qu'il peut contenir (formaté par "settext") - %IMAGE%
affiche des images trouvées dans le billet (formaté par "setimage")
- %LINK:BLOG[xyz]%
affiche la chaîne "xyz" en tant que lien vers le blog (bulle au survol du lien affichant le titre du blog) - %link:BLOG[xyz]%
affiche la chaîne "xyz" en tant que lien vers le blog (pas de bulle au survol du lien affichant le titre du blog))
- %LINK:POST[xyz]%
affiche la chaîne "xyz" en tant que lien vers le billet (bulle au survol du lien affichant le titre du billet) - %link:POST[xyz]%
affiche la chaîne "xyz" en tant que lien vers le billet (pas de bulle au survol du lien affichant le titre du billet)
- %LINK:COMM[xyz]%
affiche la chaîne "xyz" en tant que lien vers les commentaires du billet (bulle au survol du lien affichant le titre du billet) - %link:COMM[xyz]%
affiche la chaîne "xyz" en tant que lien vers les commentaires du billet (pas de bulle au survol du lien affichant le titre du billet)
- %LINK:PING[xyz]%
affiche la chaîne "xyz" en tant que lien vers les rétro-liens du billet (bulle au survol du lien affichant le titre du billet) - %link:PING[xyz]%
affiche la chaîne "xyz" en tant que lien vers les rétro-liens du billet (pas de bulle au survol du lien affichant le titre du billet)
Remarques :
- Ces codes sont facultatifs et peuvent être mis dans l'ordre que vous 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.
- Concernant les codes de formatage commençant par "%catname" et "%CATNAME" : ils n'affichent rien si le billet est sans catégorie. "xyz" est facultatif et représente ici le texte qui précéde la catégorie. Il sera affiché sans aucun transcodage.
- Concernant les codes de formatage commençant par "%LINK:" : "xyz" représente ici le texte du lien. Tous les caractères de ce texte ayant des équivalents en entités HTML seront transcodés avant affichage (exemple "<" devient "<", "&" devient "&")...
- Concernant les codes de formatage %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 (UTF8),
- 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.
- Equivalences entre certaines variables et des codes de formatage
- $blog_name = %blog%
- $post_title = %title%
- $post_date = %date%
- $nb_comment = %nbcomm%
- $txt_nbcomm = %nbcomm[]%
- $nb_trackback = %nbping%
Notes :
- le paramétrage de %TEXT% est décrit ici.
- le paramétrage de %IMAGE% est décrit ici.
- le formatage du nombre de commentaires est décrit ici.
- le formatage de la date est décrit ici.
Exemples d'utilisation du formatage d'un item :
- %DATE% : %BLOG:BLOG% - %TITLE:POST% (format par défaut)
affichera :07/10/2017 08h09 : Mirovinben - mrvbNextDoor 1.8.13
- Le %DATE%,<br/>dans le blog %BLOG:BLOG%<br/>a été publié %TITLE:POST%
affichera :Le 07/10/2017 à 08h09,
Ici, le format de la date par défaut (%d/%m/%Y %Hh%M) a été remplacé par %d/%m/%Y à %Hh%M.
dans le blog Mirovinben
a été publié mrvbNextDoor 1.8.13 - $post_date : <a href="$post_url">$post_title</a>
affichera :07/10/2017 08h09 : mrvbNextDoor 1.8.13
Utilisation uniquement des variables mises à disposition à partir de la v1.8.13.
Paramétrage de %TEXT% :
Les codes suivants sont utilisés pour paramétrer l'extraction du texte via le paramètre "settext" :
- from : provenance du texte
valeurs possibles : excerpt (chapo), content (contenu), full (tout le billet), first (chapo si présent, contenu sinon). - length : longueur maxi du texte à extraire
valeurs possibles : 0 à n
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é
Par défaut :
from=full,length=100,cut=[…]
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".
- […] s'affiche […]
Paramétrage de %IMAGE% :
Les codes suivants sont utilisés pour paramétrer l'extraction des images via le paramètre setimage :
- link : cible du lien posé sur chaque image
valeurs possibles : entry (billet), none (aucun lien). - from : provenance des images
valeurs possibles : excerpt (chapo), content (contenu), full (tout le billet), first (chapo si présent, contenu sinon). - start : rang de la première image à extraire
valeurs possibles : 1 à n
valeur par défaut : 1
si "start" inférieur à 1 ou "start" supérieur au nombre total d'images dans le billet alors 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.
- title : si "link" = "entry" et si "title" est différent de 1, alors le titre du billet dans la bulle au survol de l'image est remplacé par 'Open the post' ('Ouvrir le billet').
Par défaut :
link=none,from=full,start=1,length=1,title=1
Formatage du nombre de commentaires :
Les trois textes suivants, placés entre doubles-quotes ["] et séparés uniquement par des virgules sans espace(s), sont utilisés pour formater l'affichage du nombre de commentaires d'un billet via le paramètre setnbcom :
- none : si aucun commentaire.
- one : si un seul commentaire.
- more : si plusieurs commentaires.
Par défaut :
none="no comments",one="one comment",more="%d comments"
Remarques :
- concerne
- %nbcomm[]%
- %NBCOMM[]%
- %NBCOMM:COMM[]%
- '%d' (présent dans le texte affecté à 'more') sera remplacé par le nombre de commentaires.
- en utilisation interne (widget et fonction intNextDoor), le format par défaut sera traduit dans la langue du blog. En utilisation externe (fonction extNextDoor), il faut personnaliser setnbcom.
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.