Aggiungere una tassonomia di tag personalizzata allo schema

Possiamo aggiungere tag agli articoli in WordPress (ovvero utilizzando la tassonomia con nome "post_tag"). Questo è già mappato nello schema GraphQL tramite PostTag, associato a una voce Post.

I Custom Post Types definiti da qualsiasi tema o plugin (come "product") possono allo stesso modo avere la propria tassonomia di tag associata (come "product-tag"). Poiché queste tassonomie di tag non includono il proprio tipo specifico per lo schema GraphQL (ciò richiederebbe un'estensione tramite codice PHP), vengono risolte tramite il tipo GenericTag.

Utilizziamo i campi tag e tags per recuperare i dati dei tag, che indicano a quale tassonomia fanno riferimento tramite l'argomento di campo taxonomy. Il risultato è del tipo union TagUnion, che include voci provenienti sia da PostTag sia da GenericTag (a seconda della tassonomia della voce).

​

Configurare le tassonomie di tag interrogabili

Le tassonomie di tag che possono essere interrogate devono essere configurate esplicitamente. Questo può essere fatto in 2 punti.

Nella Configurazione dello Schema applicata all'endpoint, selezionando l'opzione "Use custom configuration" sotto "Customize configuration, or use default from Settings?" e poi selezionando gli elementi desiderati:

Questo elenco contiene tutte le tassonomie "non gerarchiche" associate ai custom post interrogabili, ovvero quelli selezionati in "Included custom post types" nelle Impostazioni per "Custom Posts". I custom post types associati a ciascuna tassonomia di tag sono mostrati sotto (CPT: ...). Se la tassonomia di tag desiderata non compare qui, assicurati che tutti i suoi custom post types associati siano presenti in tale elenco di autorizzazione.

Altrimenti, se selezioni l'opzione "Use configuration from Settings", viene utilizzato il valore definito nella sezione "Included tag taxonomies" nella pagina delle Impostazioni di Schema Custom Posts:

​

Configurazione aggiuntiva

Tramite le Impostazioni di Schema Tags, possiamo anche definire:

• Il numero predefinito di elementi da recuperare (ovvero quando l'argomento di campo limit non è impostato) durante l'interrogazione di un elenco di qualsiasi tassonomia di tag
• Il numero massimo di elementi che possono essere recuperati in una singola esecuzione della query