Adicionando uma taxonomia de categoria personalizada ao schema
Podemos adicionar categorias a posts no WordPress (ou seja, usando a taxonomia com o nome "category"). Isso já está mapeado no schema GraphQL por meio de PostCategory, associada a uma entrada Post.
Custom Post Types definidos por qualquer tema ou plugin (como "product") podem igualmente ter sua própria taxonomia de categorias associada (como "product-cat"). Como essas taxonomias de categorias não incluem um tipo específico próprio para o schema GraphQL (o que exigiria uma extensão via código PHP), elas são resolvidas por meio do tipo GenericCategory.
Usamos os campos category e categories para buscar dados de categorias, que indicam a qual taxonomia se referem por meio do argumento de campo taxonomy. O resultado é do tipo união CategoryUnion, que inclui entradas de PostCategory ou de GenericCategory (dependendo da taxonomia da entrada).
Configurando as taxonomias de categorias consultáveis
As taxonomias de categorias 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, em seguida, selecionando os itens desejados:
Esta lista contém todas as taxonomias "hierárquicas" associadas aos 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 categorias são exibidos em (CPT: ...). Se a taxonomia de categorias 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", é utilizado o valor definido na seção "Included category taxonomies" na página de Configurações de Schema Custom Posts:
Configuração adicional
Por meio das Configurações de Schema Categories, também podemos definir:
- O número padrão de elementos a recuperar (ou seja, quando o argumento de campo
limitnão está definido) ao consultar uma lista de qualquer taxonomia de categorias - O número máximo de elementos que podem ser recuperados em uma única execução de query
