MoreTpl, mon premier plugin pour Dotclear 2

Il faut bien un début à tout et ceci est mon premier plugin pour Dotclear 2. Mon premier plugin tout court d'ailleurs ! Rien de bien renversant, juste l'ajout de fonctions template dont j'ai eu besoin au cours de mes expérimentations de thèmes et que je mets à dispo ici.

Il fait quoi ton ploug ?

Il permet d'utiliser cinq nouvelles fonctions d'affichage dans les fichiers *.html des thèmes :

On avait déjà {{tpl:EntryExcerpt}}, qui récupère ce que contient le champ extrait du billet et {{tpl:EntryContent}} qui en récupère le champ du contenu. {{tpl:EntryExcerptAndContent}} récupère le tout en une seule « passe ».

Exemple d'utilisation : sur la toute première page d'accueil, afficher le premier billet en entier, que le champ Extrait soit vide ou non et n'afficher que les 400 premiers caractères de la totalité du billet pour les billets suivants et tous les billets de toutes les pages suivantes.

Permet dans le contexte d'un billet de récupérer le cat_url de la catégorie à laquelle il appartient (équivalent de ce qui est possible dans le contexte d'une boucle sur les catégories avec la fonction {{tpl:CategoryShortURL}}).

Exemple d'utilisation : affecter une class spécifique supplémentaire à la <div class="post">

Permet d'afficher le nombre de billets affectés à une catégorie (idem que dans le widget Catégories).

Exemple d'utilisation : dans la page category.html, afficher dans les infos situées en haut du main, avant ou après la description d'icelle le nombre de billets qu'elle contient. Ce nombre est renvoyé en chiffres.

{{tpl:EntryCommentCountDigit}} et {{tpl:EntryTrackbackCountDigit}}

Permet d'afficher en chiffre le nombre de commentaires. Attention, les mots « commentaire » ou « rétroliens » sont également supprimés, pensez à les ajouter dans le template si vous les souhaitez.

Exemple d'utilisation : remplacer « un commentaire » par « 1 grain de sel » ou « 1 » [avec une jolie icône de commentaire].

Je le veux !

Fiche détaillée et téléchargement sur Dotaddict.

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}}

   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 :-)

Les ateliers du klafoutis