L’essentiel à retenir ℹ️
Le bloc Boucle de requête (Query Loop) affiche une liste d’articles selon vos critères, sans plugin ni PHP. Il existe depuis WordPress 5.8 et fonctionne aussi avec un thème classique. Pour lister les derniers articles d’une catégorie sur une page : insérez le bloc, passez le Type de requête sur Personnalisée, ajoutez la catégorie dans Filtres, réglez les Éléments par page et activez le lien sur le titre. Le piège : en Par défaut, le bloc reprend la requête de la page et n’affiche que la page elle-même. Le filtre n’inclut pas les sous-catégories.
Trois articles attendus, un seul titre affiché : celui de la page qui contenait le bloc. Voilà ce que vous risquez si vous laissez le bloc Boucle de requête sur son réglage de départ.
C’est pourtant le bon outil pour afficher vos derniers articles par catégorie sans plugin. Voici ce qu’il fait, comment le configurer sur une page, et dans quels cas je garde le bloc Derniers articles, plus simple.
Une précision avant de commencer. J’ai testé le rendu sur astuceswp.fr, sous WordPress 7.1.4 et avec un thème classique, en ligne de commande et sans rien enregistrer. J’ai ensuite refait tout le parcours à l’écran sur un site de test, avec le même thème : les captures et les libellés de ce tutoriel viennent de là, et les étapes suivent la documentation officielle du bloc. Si un libellé diffère chez vous, fiez-vous à votre écran.
C’est quoi le bloc Boucle de requête (Query Loop) ?
La Boucle de requête est l’équivalent visuel de la boucle PHP de WordPress. Vous lui dites quels contenus chercher, elle les affiche selon la mise en page de votre choix. Elle est arrivée avec WordPress 5.8, en juillet 2021. Si vous ne la trouvez pas dans l’éditeur, regardez du côté de votre version de WordPress.
Ce n’est pas un bloc unique, mais une petite famille :
- Boucle de requête : décide quels contenus sortent (type, filtres, ordre, quantité).
- Modèle de publication : la mise en page répétée pour chaque résultat, en liste ou en grille. On y place le titre, l’image mise en avant, la date ou l’extrait.
- Pagination (facultative) : les liens vers les résultats suivants, avec les blocs Page précédente, Numéros de page et Page suivante.
- Aucun résultat (facultatif) : le message affiché quand la requête ne trouve rien.
Tout ce que vous modifiez dans le Modèle de publication se répète sur chaque article. Déplacez l’image au-dessus du titre une fois, et ça vaut pour toute la liste. Comme pour le bloc Accordéon ou le fil d’Ariane natif, c’est une extension de moins à maintenir.
Le piège du réglage « Par défaut »
Le bloc possède un réglage Type de requête, avec deux valeurs : Par défaut et Personnalisée.
Par défaut, le bloc reprend la requête de la page en cours. C’est exactement ce qu’il faut dans un modèle de thème, comme une archive de catégorie ou la page du blog : WordPress sait déjà quels articles afficher.
Sur une page classique, ça donne quoi ? J’ai simulé le cas sur mon site : le bloc en mode hérité a renvoyé un seul résultat, le titre de la page elle-même. Logique, puisque la requête de cette page ne porte que sur elle. La documentation le dit à sa façon : pour lister des articles sur une page, passez en Personnalisée. Tant que vous ne l’avez pas fait, les options de filtre restent masquées.
Afficher les derniers articles d’une catégorie, étape par étape
Prenons le cas le plus courant : une page qui affiche les six derniers articles d’une catégorie.
- Ouvrez votre page dans l’éditeur de blocs, puis cliquez sur le + pour insérer un bloc.
- Cherchez « Boucle de requête » et insérez le bloc.
- Choisissez un point de départ : Choisir ouvre les compositions disponibles, Partir de zéro propose des variantes simples. Je prends Partir de zéro, il y a moins à défaire.
- Sélectionnez le bloc parent Boucle de requête, au besoin via la Vue en liste, puis ouvrez les réglages du bloc dans la colonne de droite.
- Passez le Type de requête sur Personnalisée.
- Ajoutez le filtre : ouvrez le menu à trois points à côté de Filtres, cochez Taxonomies, puis saisissez le nom de votre catégorie dans le champ Catégories.
- Réglez la quantité : dans Afficher, indiquez 6 en Éléments par page. Si la ligne n’apparaît pas, ouvrez le menu à trois points à côté d’Afficher.
- Vérifiez l’ordre : Ordonner par doit être sur Des plus récents aux plus anciens, la valeur par défaut.
- Rendez les titres cliquables : sélectionnez le titre et activez Créer un lien sur le titre. Pour l’image mise en avant, c’est Créer un lien sur l’image.
- Enregistrez, puis contrôlez la page publique.
Ne sautez pas l’étape 9. La documentation prévient que les titres et les images ne sont pas toujours cliquables d’office. Une liste d’articles sur laquelle on ne peut pas cliquer, ça fait désordre.
Mon test sur astuceswp.fr, avec une requête de trois articles sur la catégorie Tutoriels WordPress (39 articles publiés) : le bloc a renvoyé les trois plus récents, dans le bon ordre, et le contrôle par une requête WordPress classique a donné la même liste.
Les réglages de la Boucle de requête à connaître
Type de publication : la boucle liste des articles par défaut. Choisissez Page, ou un type de contenu ajouté par une extension comme les produits WooCommerce, pour lister autre chose. Les filtres s’adaptent au type choisi : pour les pages, vous trouvez par exemple Parents, qui ne garde que les pages rangées sous une page donnée.
Publications épinglées : quatre choix, Inclure (par défaut), Exclure, Ignorer et Uniquement. Si un article épinglé n’a rien à faire dans cette liste, choisissez Exclure.
Décalage : saute les premiers résultats. Pratique pour une page qui met déjà l’article le plus récent en vedette : un décalage de 1 évite le doublon.
Nombre max. de pages à afficher : plafonne la pagination, si vous ne voulez pas exposer des dizaines de pages.
Vue en liste ou Vue en grille : ce choix se fait sur le Modèle de publication, dans sa barre d’outils. Pas sur le bloc parent, où on le cherche d’abord.
Recharger la page entière : ce réglage avancé est activé par défaut. Je le laisse tel quel. La documentation le présente comme l’option la plus sûre pour la navigation et l’accessibilité.
Aucun résultat : remplissez ce message. Sinon, le jour où la catégorie est vide, le visiteur tombe sur un trou dans la page.
Les autres filtres : le menu à trois points à côté de Filtres propose aussi Auteurs/autrices et Mot-clé. Deux autres options n’apparaissent que dans certains cas. Exclure ajoute l’interrupteur Exclure l’élément actuel, arrivée avec WordPress 7.1 : il ne s’affiche que si la boucle liste le même type de contenu que la publication en cours, par exemple des articles dans un article. Sur une page qui liste des articles, vous ne le verrez pas. Format n’apparaît que si votre thème gère les formats d’article. Attention au mot-clé : si vous en saisissez plusieurs, un article doit tous les contenir pour sortir. Le filtre Taxonomies sait aussi écarter des catégories ou des étiquettes, pratique pour retirer les actualités d’une liste de tutoriels.
Reste la pagination. Elle fonctionne avec un paramètre d’URL : sur mon test, le lien suivant pointait vers ?query-7-page=2. Mon conseil : sur une page d’accueil ou une page de présentation, supprimez-la et ajoutez un lien vers l’archive de la catégorie. Votre liste reste courte, et le visiteur arrive sur la vraie page de la catégorie.
Boucle de requête ou Derniers articles ?
WordPress propose aussi le bloc Derniers articles. Il mérite mieux que l’oubli.
| Besoin | Derniers articles | Boucle de requête |
|---|---|---|
| Liste simple, filtrée par catégorie | Oui | Oui |
| Pagination | Non | Oui |
| Mise en page libre (colonnes, groupes, blocs au choix) | Non | Oui |
| Pages et types de contenu personnalisés | Non | Oui |
| Filtre par mot-clé ou exclusion de catégories | Non | Oui |
Mon avis est simple : pour une liste de cinq titres en bas de page, prenez Derniers articles, c’est réglé en trente secondes. Dès que vous voulez une mise en page à vous, une pagination ou un autre type de contenu, passez à la Boucle de requête.
Et avec un thème classique ?
Ça marche. Mon site tourne sur un thème classique, sans éditeur de site : le bloc y est bien enregistré, six compositions de boucle sont disponibles côté serveur, et le rendu renvoie les bons articles avec sa pagination.
La réserve porte sur l’apparence. Sur un thème classique, c’est son CSS qui décide de l’allure de la liste, et les alignements large et pleine largeur dépendent de ce que le thème active. Sur mon site de test, avec le thème d’astuceswp.fr, la grille de trois colonnes s’affiche proprement, pagination comprise, alors que l’éditeur montre des titres dans une autre police. Avec un autre thème, le résultat peut différer : regardez donc la page publique, surtout en Vue en grille, avant de vous fier à ce que montre l’éditeur.
En pratique
Passez le bloc en Personnalisée avant tout le reste. Ajoutez votre catégorie dans Filtres, réglez la quantité, activez le lien sur le titre. Remplissez le message Aucun résultat.
Ma reco si vous n’en gardez qu’une : si votre liste affiche le titre de votre page au lieu de vos articles, ne cherchez pas plus loin, c’est le Type de requête.
Foire aux questions
Non. Le code de WordPress 7.1 construit le filtre avec l’option include_children à false : seuls les articles rangés directement dans la catégorie choisie sortent. Pour inclure une sous-catégorie, ajoutez-la dans le champ Catégories.
Oui. Saisissez-les dans le champ Catégories. D’après le code de WordPress, un article sort dès qu’il appartient à l’une d’elles : il n’a pas besoin d’être dans toutes. Le filtre sert aussi à exclure des catégories.
Oui, le bloc s’insère dans l’éditeur d’articles comme dans celui des pages. Pensez à activer l’exclusion de l’article en cours dans les filtres. Sinon, un encart « Autres articles » peut renvoyer le lecteur vers l’article qu’il est en train de lire.
Le Type de requête est resté sur Par défaut. Sélectionnez le bloc parent Boucle de requête, pas le Modèle de publication ni un titre, puis passez sur Personnalisée. Les filtres eux-mêmes restent masqués tant que vous ne les ajoutez pas avec le bouton + à côté de Filtres.
Depuis WordPress 5.8, sortie en juillet 2021. Ses réglages ont évolué depuis : l’option Ignorer des publications épinglées et l’exclusion de la publication en cours sont arrivées plus tard. Si un réglage décrit ici manque chez vous, mettez d’abord WordPress à jour.
Derniers articles affiche une liste simple, filtrable par catégorie, sans pagination ni mise en page libre. La Boucle de requête gère la pagination, les pages, les types de contenu personnalisés et une mise en page construite bloc par bloc. Pour cinq titres en bas de page, Derniers articles suffit.
Oui. Je l’ai testé sous WordPress 7.1.4 avec un thème classique : le bloc est disponible et renvoie les bons articles. L’apparence dépend du CSS de votre thème, vérifiez donc le rendu sur la page publique.
Oui. Passez le Type de requête sur Personnalisée, puis le Type de publication sur Produits. Les catégories de produits apparaissent alors dans les filtres, comme les catégories d’articles.
