{{tpl:EntryFirstImage}}

La balise {{tpl:EntryFirstImage}} extraît la première image du billet si elle existe, dans le contexte d'une boucle <tpl:Entries>. Si aucune image n'est trouvée, cette balise peut extraire la première image présente dans la description de la catégorie d'appartenance du billet (voir option with_category ci-dessous).

Note :

Seules les images issues du Gestionnaire de média sont extraites.

Attributs

size

L'attribut size permet d'afficher une image redimensionnée. Il accepte cinq valeurs1) :

  • sq format carré (48×48 pixels)
  • t format miniature (100 pixels)
  • s petit format (240 pixels)
  • m format moyen (448 pixels)
  • o format original

Par défaut, l'image est affichée dans le petit format.

class

L'attribut class ajoute une classe CSS à l'image, ce qui vous permet de personnaliser son style d'affichage.

with_category

Par défaut, si aucune image n'est trouvée dans le billet, elle n'est pas affichée. Si vous souhaitez afficher une image par défaut lorsque le billet ne contient aucune image, vous pouvez utiliser l'option with_category="1". Dans ce cas, si le billet ne contient aucune image, c'est la première image trouvée dans la description de la catégorie du billet qui sera affichée.

no_tag

Par défaut, l'image est affichée au moyen d'une balise img. Si vous ne souhaitez obtenir que l'URL de l'image, vous pouvez utiliser l'option no_tag = "1".

content_only

Par défaut, l'image est recherchée dans l'extrait et le contenu du billet. Si vous souhaitez ne rechercher l'image que dans le contenu, vous pouvez utiliser l'option content_only = "1".

cat_only

Par défaut, l'image est recherchée dans le billet courant. Si vous souhaitez afficher l'image trouvée dans la description de la catégorie, utilisez l'option cat_only = "1".

Exemple

<tpl:Entries>
  {{tpl:EntryFirstImage size="sq" class="left" with_category="1"}}
  <h2>{{tpl:EntryTitle encode_html="1"}}</h2>
  <br style="clear:both;" />
</tpl:Entries>

Ce code affiche la liste des billets, avec des miniatures carrées à gauche des titres. Si un billet n'a pas d'image, la première image de la catégorie est utilisée si elle existe.

1) Les dimensions maximales sont fournies à titre indicatif. Elles peuvent être ajustées dans les paramètres du blog.

Wiki powered by Dokuwiki.