Ajouter une taxonomie de catégories personnalisée au schéma
Nous pouvons ajouter des catégories aux articles dans WordPress (c'est-à-dire en utilisant la taxonomie nommée "category"). Cela est déjà mappé dans le schéma GraphQL via PostCategory, associé à une entrée Post.
Les Custom Post Types définis par n'importe quel thème ou plugin (comme "product") peuvent également avoir leur propre taxonomie de catégories associée (comme "product-cat"). Étant donné que ces taxonomies de catégories n'incluent pas leur propre type spécifique pour le schéma GraphQL (cela nécessiterait une extension via du code PHP), elles sont résolues via le type GenericCategory.
Nous utilisons les champs category et categories pour récupérer les données de catégories, qui indiquent à quelle taxonomie ils font référence via l'argument de champ taxonomy. Le résultat est du type union CategoryUnion, qui inclut des entrées soit de PostCategory soit de GenericCategory (selon la taxonomie de l'entrée).
Configurer les taxonomies de catégories interrogeables
Les taxonomies de catégories pouvant être interrogées doivent être explicitement configurées. Cela peut se faire en 2 endroits.
Dans la Configuration du Schéma appliquée à l'endpoint, en sélectionnant l'option "Use custom configuration" sous "Customize configuration, or use default from Settings?" puis en sélectionnant les éléments souhaités :
Cette liste contient toutes les taxonomies « hiérarchiques » associées aux types de contenu personnalisés interrogeables, c'est-à-dire ceux sélectionnés dans "Included custom post types" dans les Réglages de "Custom Posts". Les types de contenu personnalisés associés à chaque taxonomie de catégories sont affichés sous (CPT: ...). Si la taxonomie de catégories souhaitée n'apparaît pas ici, assurez-vous que tous ses types de contenu personnalisés associés figurent dans cette liste d'autorisation.
Sinon, si vous sélectionnez l'option "Use configuration from Settings", la valeur définie dans la section "Included category taxonomies" de la page des Réglages de Schema Custom Posts est utilisée :
Configuration supplémentaire
Via les Réglages de Schema Categories, nous pouvons également définir :
- Le nombre d'éléments par défaut à récupérer (c'est-à-dire lorsque l'argument de champ
limitn'est pas défini) lors de l'interrogation d'une liste de n'importe quelle taxonomie de catégories - Le nombre maximum d'éléments pouvant être récupérés en une seule exécution de requête
