Een aangepaste tag-taxonomie toevoegen aan het schema

Je kunt tags toevoegen aan berichten in WordPress (dus door gebruik te maken van de taxonomie met de naam "post_tag"). Dit is al toegewezen in het GraphQL-schema via het type PostTag, gekoppeld aan een Post-item.

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

We gebruiken de velden tag en tags om tag-gegevens op te halen, die via het veldargument taxonomy aangeven naar welke taxonomie ze verwijzen. Het resultaat is van het union-type TagUnion, dat items bevat van PostTag of GenericTag (afhankelijk van de taxonomie van het item).

​

De bevraagbare tag-taxonomieën configureren

De tag-taxonomieën die bevraagd kunnen worden, 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 'niet-hiërarchische' taxonomieën die gekoppeld zijn aan bevraagbare custom posts, d.w.z. de posts die zijn geselecteerd onder "Included custom post types" in de instellingen voor "Custom Posts". De bijbehorende custom post types van elke tag-taxonomie worden weergegeven onder (CPT: ...). Als je gewenste tag-taxonomie hier niet verschijnt, zorg er dan voor dat alle bijbehorende custom post types in die allowlist staan.

Anders, bij het selecteren van de optie "Use configuration from Settings", wordt de waarde gebruikt die is gedefinieerd onder de sectie "Included tag taxonomies" op de instellingspagina voor Schema Custom Posts:

​

Aanvullende configuratie

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

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