Ajouter une taxonomie de tags personnalisée au schéma
Nous pouvons ajouter des tags aux articles dans WordPress (c'est-à-dire en utilisant la taxonomie nommée "post_tag"). Cela est déjà mappé dans le schéma GraphQL via PostTag, 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 tags associée (comme "product-tag"). Étant donné que ces taxonomies de tags 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 GenericTag.
Nous utilisons les champs tag et tags pour récupérer les données de tags, qui indiquent à quelle taxonomie ils font référence via l'argument de champ taxonomy. Le résultat est du type union TagUnion, qui inclut des entrées soit de PostTag soit de GenericTag (selon la taxonomie de l'entrée).
Configurer les taxonomies de tags interrogeables
Les taxonomies de tags 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 « non 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 tags sont affichés sous (CPT: ...). Si la taxonomie de tags 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 tag taxonomies" de la page des Réglages de Schema Custom Posts est utilisée :
Configuration supplémentaire
Via les Réglages de Schema Tags, 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 tags - Le nombre maximum d'éléments pouvant être récupérés en une seule exécution de requête
