Een aangepaste categorie-taxonomie toevoegen aan het schema

We kunnen categorieën toevoegen aan berichten in WordPress (d.w.z. met behulp van de taxonomie met de naam "category"). Dit is al in het GraphQL-schema verwerkt via PostCategory, gekoppeld aan een Post-item.

Custom Post Types gedefinieerd door een thema of plugin (zoals "product") kunnen eveneens hun eigen categorie-taxonomie hebben die eraan is gekoppeld (zoals "product-cat"). Omdat deze categorie-taxonomieën geen eigen specifiek type voor het GraphQL-schema meebrengen (dat zou een extensie via PHP-code vereisen), worden ze opgelost via het type GenericCategory.

We gebruiken de velden category en categories om categoriegegevens op te halen, die via het veldargument taxonomy aangeven op welke taxonomie ze betrekking hebben. Het resultaat is van het union-type CategoryUnion, dat items bevat van zowel PostCategory als GenericCategory (afhankelijk van de taxonomie van het item).

​

De opvraagbare categorie-taxonomieën configureren

De categorie-taxonomieën die kunnen worden opgevraagd, moeten expliciet worden geconfigureerd. Dit kan op 2 plaatsen worden gedaan.

In de Schema Configuration die op het endpoint is toegepast, door de optie "Use custom configuration" te selecteren onder "Customize configuration, or use default from Settings?" en vervolgens de gewenste items te selecteren:

Deze lijst bevat alle "hiërarchische" taxonomieën die zijn gekoppeld aan opvraagbare custom posts, d.w.z. de taxonomieën die zijn geselecteerd bij "Included custom post types" in de instellingen voor "Custom Posts". De bijbehorende custom post types van elke categorie-taxonomie worden weergegeven onder (CPT: ...). Als je gewenste categorie-taxonomie hier niet verschijnt, controleer dan of alle bijbehorende custom post types op die allowlist staan.

Als je anders de optie "Use configuration from Settings" selecteert, wordt de waarde gebruikt die is gedefinieerd onder de sectie "Included category taxonomies" op de instellingenpagina voor Schema Custom Posts:

​

Aanvullende configuratie

Via de instellingen voor Schema Categories kunnen we ook het volgende definiëren:

• Het standaard aantal op te halen items (d.w.z. wanneer het veldargument limit niet is ingesteld) bij het opvragen van een lijst van een categorie-taxonomie
• Het maximale aantal items dat in één query-uitvoering kan worden opgehaald