MoreTpl, mon premier plugin pour Dotclear 2

icon.png

Il faut bien un début à tout et ceci est mon pre­mier plu­gin pour Dot­clear 2. Mon pre­mier plu­gin tout court d’ailleurs ! Rien de bien ren­ver­sant, juste l’ajout de fonc­tions tem­plate dont j’ai eu besoin au cours de mes expé­ri­men­ta­tions de thè­mes et que je mets à dispo ici.

Il fait quoi ton ploug ?

Il per­met d’uti­li­ser cinq nou­vel­les fonc­tions d’affi­chage dans les fichiers *.html des thè­mes :

{{tpl:EntryEx­cerp­tAnd­Con­tent}}

On avait déjà {{tpl:EntryExcerpt}}, qui récu­père ce que con­tient le champ extrait du billet et {{tpl:Entry­Con­tent}} qui en récu­père le champ du con­tenu. {{tpl:EntryEx­cerp­tAnd­Con­tent}} récu­père le tout en une seule « passe ».

Exem­ple d’uti­li­sa­tion : sur la toute pre­mière page d’accueil, affi­cher le pre­mier billet en entier, que le champ Extrait soit vide ou non et n’affi­cher que les 400 pre­miers carac­tè­res de la tota­lité du billet pour les billets sui­vants et tous les billets de tou­tes les pages sui­van­tes.

{{tpl:Entry­Ca­te­go­ry­Shor­tURL}}

Per­met dans le con­texte d’un billet de récu­pé­rer le cat_url de la caté­go­rie à laquelle il appar­tient (équi­va­lent de ce qui est pos­si­ble dans le con­texte d’une bou­cle sur les caté­go­ries avec la fonc­tion {{tpl:Cate­go­ry­Shor­tURL}}).

Exem­ple d’uti­li­sa­tion : affec­ter une class spé­ci­fi­que sup­plé­men­taire à la <div class=”post”>

{{tpl:Cate­go­ryEn­tries­Count}}

Per­met d’affi­cher le nom­bre de billets affec­tés à une caté­go­rie (idem que dans le wid­get Caté­go­ries).

Exem­ple d’uti­li­sa­tion : dans la page cate­gory.html, affi­cher dans les infos situées en haut du main, avant ou après la des­crip­tion d’icelle le nom­bre de billets qu’elle con­tient. Ce nom­bre est ren­voyé en chif­fres.

{{tpl:Entry­Com­ment­Count­Di­git}} et {{tpl:Entry­Track­ba­ck­Count­Di­git}}

Per­met d’affi­cher en chif­fre le nom­bre de com­men­tai­res. Atten­tion, les mots « com­men­taire » ou « rétro­liens » sont éga­le­ment sup­pri­més, pen­sez à les ajou­ter dans le tem­plate si vous les sou­hai­tez.

Exem­ple d’uti­li­sa­tion : rem­pla­cer « un com­men­taire » par « 1 grain de sel » ou « 1 » [avec une jolie icône de com­men­taire].

Je le veux !

Fiche détaillée et télé­char­ge­ment sur Dotad­dict.

Commentaires

1. Le lundi 8 janvier 2007, 18:21 par Chrysonline

serais-ce possible d'avoir un exemple d'utilisation dans une partie de code ? j'ai tenté d'inclure quelques tpl:xxx sans succés : sniff..

2. Le lundi 8 janvier 2007, 18:33 par chrysonline

tpl:EntryCommentCountDigit : ca marche ! Peut-on l'associer au widget "derniers billets" afin d'avoir en face des derniers billets publiés le nb de commentaires dans ce widget ?

3. Le mardi 9 janvier 2007, 07:38 par Kozlika

Je mettrai cet après-midi les cinq fonctions en action sur ce blog et en donnerai les codes à titre d'exemples.

4. Le mardi 9 janvier 2007, 18:41 par Kozlika

Sur le thème Hermione, choisir une cagétorie. Le nombre de billets est affiché en ajoutant dans le fichier category.html :

   <p>({{tpl:CategoryEntriesCount}} billets)</p>

juste avant :

   {{tpl:CategoryDescription}}

Sur cette même page des catégories, la mention du nombre de commentaires et trackbacks a été modifiée en remplaçant :

   {{tpl:EntryCommentCount}}

par :

   Vous avez causé {{tpl:EntryCommentCountDigit}} fois.

et :

   {{tpl:EntryTrackbackCountDigit}}

par :

   Vous avez envoyé {{tpl:EntryTrackbackCountDigit}} rétroliens vers ce billet.

Je pense que la raison pour laquelle tu avais l'impression que ça ne fonctionnait pas est que les pages template étaient encore dans le cache.

5. Le jeudi 11 janvier 2007, 09:03 par Chrys

ca marche ! merci Koz ! sympa tous ces TPL : un vrai jeu de légo et de module :-)

La discussion continue ailleurs

1. Le mardi 13 mars 2007, 20:19 par Aoraki, je thème

MoreTpl, mise à jour 0.6

Grâce à Mirovenbin, une nouvelle fonction a été ajoutée au plugin moreTpl : {{tpl:TagEntriesCoung}} vous permettra d'afficher le nombre de billets relatifs à un tag. Cette fonction peut être utilisée dans la page de tous les tags (tags.html) ou...