<tpl:Entries>

La balise tpl:Entries affiche une liste de billets dans de nombreuses situations. L'utilisation simple de la balise permet d'afficher les dernier billets publiés selon le contexte. Par exemple, sur la page détaillant une catégorie un appel simple à cette balise restreindra la liste aux billets de la catégorie.

Attributs

lastn

Cet attribut permet de limiter le nombre de billets renvoyés. Si aucune valeur n'est donné le nombre limite de billets donné dans les paramètres du blog sera utilisé. Une valeur de 0 listera tous les billets.

Important :

La valeur 0 ne permet pas d'afficher tous les billets. Il est possible de mettre une valeur élevée, par exemple 1000, pour lister tous les billets. (cf. ce ticket)

sortby

Par défaut les billets sont listés dans l'ordre chronologique inverse. Cet attribut permet de changer ce comportement en prenant les valeurs suivantes :

  • title : trier par titre
  • selected : trier par statut "sélectionné"
  • author : trier par auteur
  • date : trier par date
  • id : trier par ID des billets

order

Cet attribut indique dans quel sens les billets doivent être triés. Les valeurs possibles sont asc (ascendant) et desc (descendant).

type

Cet attribut permet de spécifier le type de contenu à sélectionner. En effet, Dotclear peut être étendu pour gérer différents types de contenu. Par exemple, le plugin Pages ajoute un nouveau type page qui permet d'ajouter des pages à votre blog. Les billets ordinaires correspondent au type post.

Si cet attribut n'est pas spécifié, le type utilisé par défaut est post.

url

Cet attribut permet de sélectionner un unique billet identifié par son URL.

author

Cet attribut permet de ne sélectionner que les billets d'un auteur donné. La valeur à indiquer est l'identifiant de l'utilisateur (son login).

category

Cet attribut permet de filtrer les billets par catégorie. Vous pouvez indiquer plusieurs catégories et en exclure en utilisant '?not'. L'identifiant de la catégorie est son URL simple.

Dans l'exemple suivant, on sélectionne les billets se trouvant dans la catégorie dont l'URL est "Histoires" :

<tpl:Entries category="Histoires">

Si on souhaite les billets appartenant aux catégories "histoires" ou "Nouvelles" :

<tpl:Entries category="Histoires,Nouvelles">

Enfin, si on veut afficher les billets n'appartenant pas aux catégories "Histoires" et "Nouvelles" :

<tpl:Entries category="Histoires ?not,Nouvelles ?not">

NEW Cet attribut permet également de spécifier si on souhaite obtenir les billets d'une catégorie et de ses sous-catégories. L'exemple suivant sélectionne les billets de la catégorie "Histoires" et de ses éventuelles sous-catégories :

<tpl:Entries category="Histoire ?sub">

Il est possible de combiner les marques ?not et ?sub afin d'exclure une catégorie et ses sous-catégories.

NEW Enfin, l'identifiant de catégorie #self permet de spécifier la catégorie en cours. Ceci peut être utilisé dans un billet pour afficher les billets des autres catégories :

<tpl:Entries category="#self ?not" no_context="1">

Notez bien qu'il est nécessaire d'utiliser cette marque avec l'attribut no_context="1".

no_category

Cet attribut permet d'obtenir les billets n'ayant aucune catégorie. Sa valeur est 1.

with_category

Cet attribut permet d'obtenir les billets ayant une catégorie. Sa valeur est 1. (à partir de la version 2.10 de DotClear).

selected

Cet attribut permet d'obtenir les billets marqués comme sélectionnés ou non. Si sa valeur vaut 1, seuls les billets sélectionnés seront renvoyés. Au contraire, si elle vaut 0, seuls ceux n'étant pas sélectionnés seront renvoyés.

no_content

Quand cet attribut vaut 1, le contenu même des billets ne sera pas accessible. Cela peut-être utile en terme de performance pour construire des listes ne contenant que le titre des billets.

ignore_pagination

Dans de nombreux cas (page d'accueil, détail d'une catégorie, tag, etc.) la liste des billets peut-être paginée. La pagination étant globale, elle s'applique à l'ensemble des boucles tpl:Entries que vous créez. Cet attribut, quand il a une valeur de 1 permet d'ignorer la pagination.

no_context

La boucle tpl:Entries 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é. De la même manière, cette boucle, dans le contexte d'une page d'archive sera automatiquement filtrée par date.

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

tag

NEW Cet attribut permet également de réaliser un filtre par tag au même titre que l'attribut category. L'identifiant du tag est le nom du tag (espaces compris).

Dans l'exemple suivant, on va sélectionner les billets relatif au tag "faune et flore" :

<tpl:Entries tag="faune et flore">

age

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

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

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

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

<tpl:Entries age="last week">

Exemples

Les 15 derniers billets de l'auteur "john"

<tpl:Entries lastn="15" author="john">

Les billets triés par titre dans l'ordre alphabétique

<tpl:Entries sortby="title" order="asc">

Les 3 derniers billets de chaque catégorie du blog

<tpl:Categories>
  <h2>{{tpl:CategoryTitle}}</h2>
  <tpl:Entries lastn="3">
    <p>{{tpl:EntryTitle}}</p>
  </tpl:Entries>
</tpl:Categories>

Tous les titres des billets de la catégorie courante et de ses sous-catégories

<tpl:Entries category="#self ?sub" no_context="1">
    <p>{{tpl:EntryTitle}}</p>
</tpl:Entries>

Wiki powered by Dokuwiki.