Adicionando uma taxonomia de tag personalizada ao schema

Podemos adicionar tags a posts no WordPress (ou seja, usando a taxonomia com o nome "post_tag"). Isso já está mapeado no schema GraphQL por meio do tipo PostTag, associado a uma entrada Post.

Custom Post Types definidos por qualquer tema ou plugin (como "product") podem igualmente ter sua própria taxonomia de tags associada (como "product-tag"). Como essas taxonomias de tags não incluem seu próprio tipo específico para o schema GraphQL (o que exigiria uma extensão via código PHP), elas são resolvidas por meio do tipo GenericTag.

Usamos os campos tag e tags para buscar dados de tags, que indicam a qual taxonomia se referem por meio do argumento de campo taxonomy. O resultado é do tipo union TagUnion, que inclui entradas de PostTag ou GenericTag (dependendo da taxonomia da entrada).

​

Configurando as taxonomias de tags consultáveis

As taxonomias de tags que podem ser consultadas devem ser configuradas explicitamente. Isso pode ser feito em 2 lugares.

Na Configuração do Schema aplicada ao endpoint, selecionando a opção "Use custom configuration" em "Customize configuration, or use default from Settings?" e depois selecionando os itens desejados:

Esta lista contém todas as taxonomias "não hierárquicas" associadas a custom posts consultáveis, ou seja, aqueles selecionados em "Included custom post types" nas Configurações de "Custom Posts". Os custom post types associados a cada taxonomia de tags são exibidos em (CPT: ...). Se a taxonomia de tags desejada não aparecer aqui, certifique-se de que todos os seus custom post types associados estejam nessa lista de permissões.

Caso contrário, ao selecionar a opção "Use configuration from Settings", o valor definido na seção "Included tag taxonomies" na página de Configurações de Schema Custom Posts será utilizado:

​

Configuração adicional

Por meio das Configurações de Schema Tags, também podemos definir:

• O número padrão de elementos a recuperar (ou seja, quando o argumento de campo limit não está definido) ao consultar uma lista de qualquer taxonomia de tags
• O número máximo de elementos que podem ser recuperados em uma única execução de query