Añadir una taxonomía de categorías personalizada al esquema

Podemos añadir categorías a las entradas en WordPress (es decir, usando la taxonomía con nombre "category"). Esto ya está mapeado en el esquema de GraphQL mediante PostCategory, asociado a una entrada de Post.

Los Custom Post Types definidos por cualquier tema o plugin (como "product") también pueden tener su propia taxonomía de categorías asociada (como "product-cat"). Dado que estas taxonomías de categorías no incluyen su propio tipo específico para el esquema de GraphQL (eso requeriría una extensión mediante código PHP), se resuelven a través del tipo GenericCategory.

Usamos los campos category y categories para obtener los datos de las categorías, los cuales indican a qué taxonomía hacen referencia mediante el argumento de campo taxonomy. El resultado es del tipo unión CategoryUnion, que incluye entradas tanto de PostCategory como de GenericCategory (según la taxonomía de la entrada).

​

Configurar las taxonomías de categorías consultables

Las taxonomías de categorías que se pueden consultar deben configurarse explícitamente. Esto se puede hacer en 2 lugares.

En la Configuración del Esquema aplicada al endpoint, seleccionando la opción "Use custom configuration" bajo "Customize configuration, or use default from Settings?" y luego eligiendo los elementos deseados:

Esta lista contiene todas las taxonomías "jerárquicas" que están asociadas a entradas personalizadas consultables, es decir, las seleccionadas en "Included custom post types" en los Ajustes de "Custom Posts". Los tipos de contenido personalizados asociados a cada taxonomía de categorías se muestran bajo (CPT: ...). Si la taxonomía de categorías que deseas no aparece aquí, asegúrate de que todos sus tipos de contenido personalizados asociados estén en esa lista de permitidos.

De lo contrario, si seleccionas la opción "Use configuration from Settings", se utiliza el valor definido en la sección "Included category taxonomies" en la página de Ajustes de Schema Custom Posts:

​

Configuración adicional

A través de los Ajustes de Schema Categories, también podemos definir:

• El número de elementos por defecto a recuperar (es decir, cuando el argumento de campo limit no está configurado) al consultar una lista de cualquier taxonomía de categorías
• El número máximo de elementos que pueden recuperarse en una única ejecución de consulta