Bloc de requête de termes

Le bloc Requête de termes affiche une liste ou une grille de termes taxonomiques (tels que des catégories, des étiquettes ou des taxonomies personnalisées). Il est particulièrement utile dans les modèles (par exemple, un index « Catégories » ou une page d’annuaire) où vous souhaitez répertorier les termes et définir l’apparence de chacun d’eux.

Prérequis

• WordPress 6.9 ou version ultérieure.
• Un thème de blocs permettant de modifier les modèles dans l’éditeur de site.
• La taxonomie que vous souhaitez afficher doit être publique et disponible dans l’éditeur (show_in_rest activé).

Anatomie du bloc Requête de termes

L’inspecteur du bloc fournit un aperçu rapide de la structure du bloc Requête de termes. Chaque partie vous donne accès à différents réglages :

• Requête de termes : configurez les paramètres de la requête.
• Modèle de terme : choisissez la façon dont le contenu est affiché, sous forme de liste ou de grille.
• Nom du terme : affichez le nom du terme.
• Description du terme : affichez la description du terme.
• Nombre de termes : affichez le nombre de résultats pour chaque terme.

Ajouter le bloc Requête de termes à un modèle

1. Accédez à Apparence > Éditeur.
2. Ouvrez le modèle dans lequel vous souhaitez faire apparaître les termes (par exemple, un modèle personnalisé « Catégories »).
3. Placez votre curseur à l’emplacement souhaité.
4. Ouvrez l’outil d’insertion de blocs (+), recherchez « Requête de termes » et sélectionnez-le.

Configuration du bloc

Après avoir ajouté le bloc Requête de termes , vous verrez deux options :

Ces variantes proposent deux options de mise en page différentes :

• Nom : affiche uniquement le nom du terme.
• Nom et nombre : affiche le nom et le nombre d’éléments de ce terme.

Comment personnaliser l’apparence

Il existe de nombreuses façons de personnaliser le bloc Requête de termes, notamment parce qu’il est composé de blocs imbriqués que vous pouvez réorganiser, ajouter, etc. Lorsque vous personnalisez un bloc dans le bloc Requête de termes, les modifications s’appliquent à tous les blocs du même type. Lors de la personnalisation de ce bloc, il peut être utile d’utiliser la vue en liste disponible dans la barre d’outils supérieure. Voici quelques idées de personnalisation pour commencer :

• Vous pouvez modifier la largeur de différents éléments du bloc Requête de termes.
• Vous pouvez modifier l’alignement des blocs au sein du bloc Requête de termes.
• Vous pouvez réorganiser les blocs comme vous le souhaitez, en les faisant glisser-déposer ou en utilisant les boutons de déplacement.
• Vous pouvez modifier le nombre de termes affichés en sélectionnant le bloc Requête de termes et en ajustant l’option Nombre maximal de termes dans les réglages du bloc.
• Vous pouvez définir différentes options de couleur pour les blocs imbriqués.
• Vous pouvez modifier l’affichage du nombre de termes en sélectionnant le bloc Nombre de termes et en modifiant le format dans la barre d’outils du bloc.
• Vous pouvez afficher la description du terme en sélectionnant le bloc Description du terme et en ajustant les styles comme nécessaire.

Barre d’outils du bloc

Pour afficher la barre d’outils du bloc, cliquez sur le bloc : la barre d’outils s’affichera. Chaque bloc possède des icônes uniques dans sa barre d’outils ainsi que des commandes spécifiques permettant de le manipuler directement dans l’éditeur. Le bloc Requête de termes comprend les éléments suivants :

• Transformer en.
• Aligner : aucune, largeur large, pleine largeur.
• Déplacer/glisser pour repositionner dans le modèle.
• Plus d’options (dupliquer, verrouiller, supprimer, etc.).

Transformer en

Cliquez sur le bouton « Transformer » pour convertir le bloc Boucle de requête en bloc « Groupe » ou « Colonnes ».  

Icône de déplacement

Pour faire glisser-déposer le bloc vers un nouvel emplacement, cliquez sur le rectangle composé de points et maintenez le bouton enfoncé, puis faites-le glisser vers le nouvel emplacement. La ligne bleue indique où le bloc sera placé. Relâchez le bouton gauche de la souris lorsque vous avez trouvé le nouvel emplacement où placer le bloc.

Flèches de déplacement

Les icônes en forme de flèches vers le haut et vers le bas permettent de déplacer le bloc vers le haut ou vers le bas de la page.

Des instructions détaillées sur le déplacement d’un bloc dans l’éditeur sont disponibles ici

Alignement

Utilisez l’outil de modification de l’alignement pour aligner le bloc Boucle de termes. Choisissez l’une des options suivantes :

• Aucun – laisse le bloc à sa taille actuelle.
• Largeur large – augmente la largeur du bloc au-delà de la largeur du contenu.
• Pleine largeur – étend le bloc afin qu’il couvre toute la largeur de l’écran.

Les réglages d’alignement « Largeur large » et « Pleine largeur » doivent être activés par votre thème WordPress. 

Vue en liste (par défaut)

Affiche vos termes sous forme de liste empilée. Sélectionnez le bloc Modèle de terme pour le modifier.

Vue en grille

Affiche vos termes sous forme de grille. Sélectionnez le bloc Modèle de terme pour le modifier.

Options

Le bouton Options de la barre d’outils d’un bloc vous offre davantage de fonctionnalités pour personnaliser le bloc. 

En savoir plus sur ces réglages et d’autres.

Réglages du bloc

Les blocs internes utilisent la largeur du contenu

Cette option vous permet de configurer les réglages de justification, de largeur du contenu et de largeur large pour tous les blocs imbriqués dans le bloc Boucle de requête.

Trier par

• Nom : A > Z
• Nom : Z > A
• Nombre : du plus élevé au plus faible
• Nombre : du plus faible au plus élevé

Termes sélectionnés

Cette option vous permet de choisir les taxonomies spécifiques à afficher. Recherchez simplement les éléments à ajouter et sélectionnez-les.

Afficher les termes vides

Cette option vous permet d’afficher les termes même lorsqu’ils sont vides. Elle est désactivée par défaut.

Afficher les termes imbriqués

Cette option vous permet d’afficher les termes imbriqués. Elle est désactivée par défaut.

Nombre maximal de termes

Cette option vous permet de limiter le nombre de termes à afficher. Pour afficher tous les termes, utilisez 0 (zéro).

Réglages avancés

L’onglet Avancé vous permet d’ajouter une classe CSS à votre bloc, afin d’écrire du CSS personnalisé et de styliser le bloc comme vous le souhaitez. Il vous permet également d’attribuer un élément HTML.

Démonstration

Conseils

• Utilisez la liste pour les taxonomies hiérarchiques ; utilisez la grille pour parcourir rapidement de nombreux termes.
• Gardez le nom du terme bien visible ; ajoutez une description du terme pour fournir du contexte sur les pages d’atterrissage.
• Utilisez l’option Masquer les termes vides pour éviter les archives vides et conserver une liste pertinente.
• Enregistrez une section Requête de termes configurée en tant que composition afin de la réutiliser dans plusieurs modèles.

Foire aux questions

Puis-je afficher uniquement les termes de premier niveau ?

• Oui. Ne définissez pas de parent et désactivez l’option Inclure les sous-termes.

Puis-je afficher une taxonomie personnalisée ?

• Oui, si elle est publique et enregistrée pour être affichée dans l’éditeur (show_in_rest true).

Puis-je lier le nom du terme à son archive ?

• Le nom du terme est généralement lié par défaut à l’archive du terme. Vous pouvez contrôler les liens supplémentaires (comme le nombre de termes) dans les réglages de son bloc.