vendredi 25 septembre 2026

À propos

Contact

Lexique · Éditeur de blocs

Bloc Boucle de requête

En anglais : « Query Loop block »

Le bloc Boucle de requête affiche une liste d'articles ou d'un autre type de contenu selon des critères configurables, sans écrire de code PHP, à la manière d'une boucle WP_Query.

Afficher les trois derniers articles d’une catégorie, ou les produits les mieux notés, demandait autrefois un modèle PHP personnalisé bâti autour d’une boucle WP_Query. Le bloc Boucle de requête reproduit ce mécanisme directement dans l’éditeur : il interroge la base de données selon les filtres choisis (type de contenu, taxonomie, auteur, tri, nombre d’éléments) et répète, pour chaque résultat, une disposition de blocs enfants qu’on personnalise librement.

Fonctionnement dans WordPress

À l’intérieur du bloc se trouve un bloc « Élément de modèle », lui-même conteneur de blocs comme Titre de l’article, Extrait ou Image mise en avant, répété une fois par résultat de la requête grâce à un contexte de bloc qui transmet l’identifiant de l’article courant. Le bloc gère aussi, en option, un bloc Pagination de requête pour naviguer entre les pages de résultats, et peut hériter du contexte de la page (archive, résultat de recherche) plutôt que définir sa propre requête.

Cas pratique

  • Créer une page d’accueil affichant les cinq derniers articles du blog avec image, titre et extrait, sans écrire une seule ligne de PHP.
  • Utiliser ce bloc dans une partie de gabarit d’archive pour lister automatiquement les articles d’une catégorie, en profitant de la requête déjà définie par la hiérarchie des gabarits.

Pièges fréquents

Empiler plusieurs blocs Boucle de requête avec des filtres complexes sur une même page peut multiplier les requêtes à la base de données et ralentir le chargement ; pour des besoins avancés ou très personnalisés, un développeur reste parfois plus efficace en construisant sa propre requête personnalisée en PHP.