Le bloc Boucle de requête est un bloc avancé permettant d’afficher une liste de publications à partir de paramètres spécifiques. Cela fonctionne comme une boucle PHP mais ne nécessite pas d’écrire du code. C’est une sorte de version avancée du bloc Derniers articles. À l’aide des différentes compositions d’affichage intégrées dans les réglages du bloc, vous pouvez créer une page de portfolio ou encore une page qui affiche la liste de vos recettes favorites.
Afin de connaître la procédure à suivre pour ajouter un bloc, veuillez consulter l’article Ajouter un nouveau bloc.
Configuration du bloc
Après avoir inséré un bloc Boucle de requête, vous pouvez choisir une mise en page prédéfinie dans une liste de compositions existantes en cliquant sur Choisir, ou partir d’une page blanche en cliquant sur Partir de zéro.
L’option Choisir vous permet de choisir une mise en page prédéfinie parmi une liste de compositions. À noter que le nombre de compositions disponibles et leur apparence dépend du thème utilisé.
L’option Partir de zéro vous permet de choisir quels éléments afficher comme par exemple : Titre et date, Titre et extrait, Titre, date et extrait, etc.
Que vous partiez de zéro ou que vous choisissiez une composition, le bloc Boucle de requête est créé à partir de différents blocs enfants tels que le bloc Modèle de publication, Titre de publication ou le bloc Extrait. Vous n’aurez pas la possibilité de modifier le contenu de ces blocs enfants, mais vous pourrez en revanche facilement en personnaliser la position, l’apparence et la mise en page.
Personnaliser l’apparence du bloc Boucle de requête
Il y a de nombreuses façons de personnaliser le bloc, du fait que ce bloc est en fait un agencement de blocs imbriqués. Lorsque vous personnalisez un bloc présent à l’intérieur du bloc Boucle de requête, les modifications s’appliquent à tous les blocs du même type pour chaque publication remontée par la boucle. Lors de cette modification, il peut être pratique d’utiliser la Vue en liste disponible à partir de la barre d’outils supérieure de l’éditeur de blocs.
Voici quelques idées de personnalisation pour vous aider à débuter :
- Modifiez la largeur des éléments.
- Modifiez l’alignement des blocs au sein de la boucle.
- Ajoutez des blocs supplémentaires, tels que le bloc Auteur/autrice ou le bloc Extrait.
- Réorganisez les blocs à votre guise, en glissant-déposant les blocs ou en utilisant les outils de déplacement du bloc vers le haut ou vers le bas.
- Modifiez le nombre de publications listées en sélectionnant le bloc Boucle de requête puis les Réglages d’affichage disponibles dans la barre d’outils du bloc.
- Utilisez les options de couleurs disponibles dans les options de réglages des blocs enfants du bloc Boucle de requête.
- Ajoutez des miniatures en utilisant le bloc Image mise en avant.
Barre d’outils du bloc
Chaque bloc dispose d’une barre d’outils vous permettant de le manipuler directement dans l’éditeur. Parmi ces outils, on distingue des outils communs, présentés dans l’article Barre d’outils des blocs, et d’éventuels outils spécifiques, décrits ci-dessous.
Réglages d’affichage
- Éléments par page – Choisissez le nombre de publications à afficher dans la boucle.
- Décalage – Forcez la boucle à ignorer un certain nombre de publications avant de commencer à les afficher.
- Nombre maximal de pages – Limiter le nombre de pages de résultats à afficher dans la pagination de la boucle.
Remplacer
Le bouton Remplacer permet de remplacer la composition actuelle par une autre, dans la fenêtre modale Choisir une composition.
Réglages du bloc
Selon les blocs, divers réglages sont disponibles dans la colonne latérale des réglages. Parmi ceux-ci, on distingue les réglages communs (à une majorité de blocs) des réglages spécifiques, décrits ci-dessous.
Réglages
Hériter la requête à partir du modèle
Ceci est une option que vous pouvez activer ou désactiver, selon que vous souhaitez ou non personnaliser la requête dont dépend votre boucle. Si vous l’activez, certaines options de personnalisation seront masquées car elles dépendront du fichier modèle dont dépend la boucle. Si vous la désactivez, plusieurs réglages complémentaires apparaîtront, afin de vous permettre de paramétrer entièrement votre boucle.
Type de publication
Choisissez dans la liste déroulante le Type de publication à afficher dans le bloc Boucle de requête.
Ordonner par
- Des plus récents aux plus anciens (par défaut).
- Des plus anciens aux plus récents.
- A Z – Alphabétique de A à Z.
- Z A – Alphabétique de Z à A.
Publications épinglées
Ce réglage concerne les articles et vous permet de choisir parmi les options suivantes :
- Inclure (par défaut) – Affiche les articles épinglés.
- Exclure – Retire les articles épinglés de la boucle.
- Uniquement – N’affiche que les articles épinglés.
Forcer le rechargement de la page
Lorsque ce réglage est activé, la navigation entre les pages nécessite le rechargement complet de la page plutôt qu’un rechargement partiel uniquement du bloc.
Filtres
Cette section vous permet de définir comment filtrer les publications qui seront affichées dans la boucle de requête. Les filtres disponibles dépendent du type de publication sélectionné.
Si vous ne voyez pas cette section, permutez le réglage d’héritage de la requête vu plus haut.
Si aucun filtre n’est activé, cliquez sur le bouton Options de Filtres (icône Plus ou trois points superposés) et choisissez un ou plusieurs filtre(s).
- Taxonomies – Permet de filtrer les publications en fonction des taxonomies disponibles pour les publications de ce bloc. Si vous sélectionnez le type de publication Article, un filtrage par Catégories et par Étiquettes sera disponible.
- Auteurs/autrices – Permet de n’inclure que les publications écrites par une ou plusieurs personnes.
- Mot-clé – Permet d’inclure uniquement les publications comportant le mot clé saisi dans le champ. Si vous saisissez plusieurs mots clés, un opérateur « ET » est implicitement ajouté, seules les publications comportant les mots saisis seront alors présentes.
Avancé
L’onglet Avancé vous permet d’accéder aux réglages avancés des blocs.
Ressources
Traduit par Jb Audras
Relu par Didier Demory & Jenny Dupuy
Dernière mise à jour le 28 août 2024
Contribuer à la documentation en français de WordPress
Journal des modifications
28 août 2024 – Marie Comet :
- Configuration du bloc (introduction) ;
- Suppression des outils déplacés dans le bloc Modèle de publication ;
- Ajout du réglage Forcer le rechargement de la page (version 6.4) ;
- Mise à jour des captures d’écran, suppression des vidéos obsolètes ;
- En conformité avec la version 6.6.
5 janvier 2023 – Marie Comet :
- La barre d’outils a été modifiée : nouvelle capture d’écran et adaptation du texte descriptif des outils.
- Dans les réglages, modifications de l’interface pour les filtres