La balise tpl:Comments affiche une liste de commentaires dans deux contextes différents :

• A l'intérieur d'un billet (dans une boucle tpl:Entries par exemple), les commentaires récupérés seront les commentaires de ce billet
• En dehors d'un billet, tous les commentaires seront récupérés, tous billets confondus, en fonction du contexte de la page

Les commentaires renvoyés sont systématiquement triés par date.

Cet attribut permet de limiter le nombre de commentaires renvoyés. Si aucune valeur n'est donnée ou si la valeur est fixée à 0, tous les commentaires seront affichés.

Cas particulier : cette balise est aussi utilisée dans le cas de génération de flux RSS/Atom. Dans ce cas bien précis, le nombre de commentaires récupérés sera tronqué par le nombre maximum de commentaires par flux, spécifié dans la configuration du blog

Cet attribut, s'il est positionné à 1 permet de récupérer indifféremment les commentaires et les rétroliens dans la liste des commentaires retournés.

Cet attribut indique dans quel ordre seront retournés les commentaires :

• asc indique que les commentaires seront retournés du plus ancien au plus récent
• desc indique que les commentaires seront retournés du plus récent au plus ancien.

Par défaut, les commentaires sont retournés du plus ancien au plus récent ("asc")

La boucle tpl:Comments prend en compte différents filtres imposés par le contexte. Par exemple, si vous intégrez cette boucle dans une boucle tpl:Categories, le filtrage par catégorie sera automatiquement appliqué. Les éléments de contexte actuellement pris en compte sont :

• La catégorie courante
• La langue courante

Cet attribut, quand il a une valeur de 1 permet de ne pas prendre en compte des filtres.

Quand cet attribut vaut 1, le contenu même des commentaires ne sera pas accessible. Cela peut-être utile en terme de performance pour construire des listes ne contenant que l'auteur ou la date des commentaires.

NEW Cet attribut permet de réaliser un filtre temporel sur les commentaires renvoyés.

Dans l'exemple suivant, on va sélectionner les commentaires qui datent de moins de deux jours :

<tpl:Comments age="−2 days">

On peut également être littéral, en indiquant vouloir sélectionner les commentaires de la dernière semaine glissante :

<tpl:Comments age="last week">

<tpl:Comments lastn="15" order="desc">

<tpl:Categories>
  <h2>{{tpl:CategoryTitle}}</h2>
  <tpl:Comments lastn="3">
    <p>{{tpl:CommentContent}}</p>
  </tpl:Comments>
</tpl:Categories>