Eine benutzerdefinierte Tag-Taxonomie zum Schema hinzufügen

Wir können in WordPress Tags zu Beiträgen hinzufügen (d. h. mit der Taxonomie mit dem Namen "post_tag"). Dies ist bereits im GraphQL-Schema über PostTag abgebildet, das einem Post-Eintrag zugeordnet ist.

Custom Post Types, die von einem beliebigen Theme oder Plugin definiert werden (wie "product"), können ebenso eine eigene Tag-Taxonomie haben (wie "product-tag"). Da diese Tag-Taxonomien keinen eigenen spezifischen Typ für das GraphQL-Schema mitbringen (das würde eine Erweiterung über PHP-Code erfordern), werden sie über den Typ GenericTag aufgelöst.

Wir verwenden die Felder tag und tags, um Tag-Daten abzurufen, die über das Feldargument taxonomy angeben, auf welche Taxonomie sie sich beziehen. Das Ergebnis ist vom Union-Typ TagUnion, der Einträge aus entweder PostTag oder GenericTag enthält (je nach Taxonomie des Eintrags).

​

Die abfragbaren Tag-Taxonomien konfigurieren

Die Tag-Taxonomien, die abgefragt werden können, müssen explizit konfiguriert werden. Dies kann an 2 Stellen erfolgen.

In der Schema-Konfiguration, die auf den Endpoint angewendet wird, indem du die Option "Use custom configuration" unter "Customize configuration, or use default from Settings?" auswählst und dann die gewünschten Elemente auswählst:

Diese Liste enthält alle „nicht-hierarchischen" Taxonomien, die abfragbaren Custom Posts zugeordnet sind, d. h. jene, die unter „Included custom post types" in den Einstellungen für „Custom Posts" ausgewählt wurden. Die Custom Post Types, die jeder Tag-Taxonomie zugeordnet sind, werden unter (CPT: ...) angezeigt. Wenn deine gewünschte Tag-Taxonomie hier nicht erscheint, stelle sicher, dass alle zugehörigen Custom Post Types in dieser Zulassungsliste enthalten sind.

Wenn du stattdessen die Option "Use configuration from Settings" auswählst, wird der Wert verwendet, der im Abschnitt "Included tag taxonomies" auf der Einstellungsseite von Schema Custom Posts definiert ist:

​

Zusätzliche Konfiguration

Über die Einstellungen von Schema Tags können wir außerdem Folgendes definieren:

• Die Standardanzahl der abzurufenden Elemente (d. h. wenn das Feldargument limit nicht gesetzt ist) beim Abfragen einer Liste einer beliebigen Tag-Taxonomie
• Die maximale Anzahl von Elementen, die in einer einzelnen Abfrageausführung abgerufen werden können