Configurare il plugin
Configurare il pluginAggiungere una tassonomia di categorie personalizzata allo schema

Aggiungere una tassonomia di categorie personalizzata allo schema

Possiamo aggiungere categorie agli articoli in WordPress (cioè utilizzando la tassonomia con nome "category"). Questo è già mappato nello schema GraphQL tramite PostCategory, 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 categorie associata (come "product-cat"). Poiché queste tassonomie di categorie non includono un proprio tipo specifico per lo schema GraphQL (ciò richiederebbe un'estensione tramite codice PHP), vengono risolte tramite il tipo GenericCategory.

Utilizziamo i campi category e categories per recuperare i dati delle categorie, che indicano a quale tassonomia fanno riferimento tramite l'argomento di campo taxonomy. Il risultato è del tipo unione CategoryUnion, che include voci provenienti da PostCategory oppure da GenericCategory (a seconda della tassonomia della voce).

Tipo CategoryUnion

Configurare le tassonomie di categorie interrogabili

Le tassonomie di categorie 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 quindi selezionando gli elementi desiderati:

Selezione delle tassonomie di categorie consentite nella Configurazione dello Schema

Questo elenco contiene tutte le tassonomie "gerarchiche" associate ai custom post interrogabili, cioè quelli selezionati in "Included custom post types" nelle Impostazioni per "Custom Posts". I custom post types associati a ciascuna tassonomia di categorie sono mostrati sotto (CPT: ...). Se la tassonomia di categorie desiderata non appare 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 category taxonomies" della pagina delle Impostazioni di Schema Custom Posts:

Selezione delle tassonomie di categorie consentite nelle Impostazioni
Selezione delle tassonomie di categorie consentite nelle Impostazioni

Configurazione aggiuntiva

Tramite le Impostazioni di Schema Categories, possiamo anche definire:

  • Il numero predefinito di elementi da recuperare (cioè quando l'argomento di campo limit non è impostato) durante l'interrogazione di un elenco di una qualsiasi tassonomia di categorie
  • Il numero massimo di elementi che possono essere recuperati in una singola esecuzione di query
Impostazioni per i limiti delle Categorie
Impostazioni per i limiti delle Categorie