Añadir una taxonomía de etiquetas personalizada al esquema
Podemos añadir etiquetas a las entradas en WordPress (es decir, usando la taxonomía con nombre "post_tag"). Esto ya está mapeado en el esquema de GraphQL mediante PostTag, 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 etiquetas asociada (como "product-tag"). Dado que estas taxonomías de etiquetas 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 GenericTag.
Usamos los campos tag y tags para obtener los datos de las etiquetas, los cuales indican a qué taxonomía hacen referencia mediante el argumento de campo taxonomy. El resultado es del tipo unión TagUnion, que incluye entradas tanto de PostTag como de GenericTag (según la taxonomía de la entrada).
Configurar las taxonomías de etiquetas consultables
Las taxonomías de etiquetas 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 "no 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 etiquetas se muestran bajo (CPT: ...). Si la taxonomía de etiquetas 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 tag taxonomies" en la página de Ajustes de Schema Custom Posts:
Configuración adicional
A través de los Ajustes de Schema Tags, también podemos definir:
- El número de elementos por defecto a recuperar (es decir, cuando el argumento de campo
limitno está configurado) al consultar una lista de cualquier taxonomía de etiquetas - El número máximo de elementos que pueden recuperarse en una única ejecución de consulta
