# Bloc Post Template dans une Query Loop : personnaliser chaque carte

> Comment composer librement l'intérieur de chaque carte d'article affichée par le bloc Query Loop, sans écrire une ligne de PHP ni de bloc dynamique.

- Auteur : Clément Hadrot
- Publié le : 2022-02-14
- Mis à jour le : 2022-02-14
- Catégorie : FSE
- URL : https://wpmoderne.dev.wordpress-developpement.fr/fse/bloc-post-template-query-loop-personnaliser-chaque-carte/

## L’essentiel

- Un seul modèle appliqué à tous les articles de la boucle
- Composition libre avec les blocs habituels
- Modification synchronisée sur toutes les cartes

Depuis la sortie de WordPress 5.9 et l'arrivée officielle de l'éditeur de site dans le cœur du logiciel, le bloc Query Loop s'impose comme la brique centrale pour afficher des listes d'articles sans code PHP. Mais un point reste souvent mal compris par les intégrateurs qui découvrent ce bloc : comment personnaliser précisément ce qui s'affiche à l'intérieur de chaque carte d'article ?

La réponse tient dans un bloc enfant particulier, presque invisible dans l'inspecteur : Post Template, techniquement `core/post-template`. C'est lui qui définit, une seule fois, la structure répétée pour chaque article de la liste.

## Comprendre la relation entre Query Loop et Post Template

Le bloc Query Loop se contente de définir la requête : quel type de contenu afficher, combien d'articles, selon quel ordre, avec quel filtre de taxonomie éventuel. Il ne s'occupe jamais lui-même de l'apparence visuelle de chaque article : cette responsabilité revient entièrement au bloc Post Template imbriqué à l'intérieur.

Concrètement, tout ce que l'on place dans ce Post Template — un bloc Image mise en avant, un Titre d'article, un Résumé, une Date — sera répété automatiquement pour chaque article renvoyé par la requête, avec les données propres à chaque article injectées à la volée.

## Composer une carte d'article personnalisée, étape par étape

1. Insérer un bloc Query Loop dans un gabarit d'archive ou une page, puis choisir la disposition en grille plutôt qu'en liste simple si un rendu de type « cartes » est souhaité.
2. Ouvrir le bloc Post Template généré automatiquement à l'intérieur, qui apparaît comme un conteneur presque vide au premier abord.
3. Ajouter un bloc Groupe à l'intérieur de ce Post Template, pour structurer visuellement chaque carte avec un fond et un espacement homogène.
4. Insérer, dans ce Groupe, un bloc Image mise en avant, un bloc Titre d'article en lien vers l'article complet, puis un bloc Résumé d'article limité à vingt mots.
5. Ajouter un bloc Termes de taxonomie pour afficher la catégorie de l'article directement sur la carte, un détail visuel qui a fait la différence sur ce projet précis.

> L'essentiel à retenir : Un seul modèle appliqué à tous les articles de la boucle ; Composition libre avec les blocs habituels ; Modification synchronisée sur toutes les cartes

## Un piège fréquent : modifier une seule carte par erreur

Un intégrateur débutant sur ce bloc a un jour tenté de personnaliser l'apparence d'un seul article dans la liste affichée, en modifiant directement ce qui ressemblait à une carte isolée dans l'éditeur. En réalité, toute modification à l'intérieur du Post Template s'applique simultanément à tous les articles de la boucle, car il n'existe qu'un seul modèle, appliqué en boucle sur chaque résultat de la requête.

Cette confusion est fréquente au début, car l'éditeur affiche visuellement plusieurs cartes distinctes, ce qui laisse croire à tort que chacune est modifiable indépendamment des autres.

## Aller plus loin avec des styles conditionnels

Pour varier légèrement l'apparence entre articles, par exemple mettre en avant le tout premier résultat de la boucle avec une taille de police plus grande, il faut sortir du cadre strict du Post Template et recourir à un bloc dynamique personnalisé, ou accepter une apparence uniforme pour l'ensemble des cartes. Le bloc natif, à ce stade, ne propose aucune option de variation conditionnelle intégrée.

> Un seul modèle pour toutes les cartes n'est pas une limite gênante, c'est au contraire ce qui garantit une cohérence visuelle sans effort sur toute future publication.

## Notre verdict

Le duo Query Loop et Post Template couvre aujourd'hui la grande majorité des besoins d'affichage de listes d'articles sans code, à condition de bien comprendre que la personnalisation se fait sur un modèle unique et non carte par carte. C'est un gain de temps considérable comparé à un développement PHP équivalent en thème classique.

Je recommande de toujours composer d'abord la carte type sur un seul article de test avant de brancher la requête finale, pour éviter de naviguer entre plusieurs versions de la boucle pendant la mise en page.