Eine benutzerdefinierte Kategorie-Taxonomie zum Schema hinzufügen
Wir können in WordPress Kategorien zu Beiträgen hinzufügen (d. h. mithilfe der Taxonomie mit dem Namen "category"). Dies ist im GraphQL-Schema bereits über PostCategory abgebildet, das einem Post-Eintrag zugeordnet ist.
Custom Post Types, die von einem beliebigen Theme oder Plugin definiert werden (wie "product"), können ebenfalls eine eigene Kategorie-Taxonomie zugeordnet haben (wie "product-cat"). Da diese Kategorie-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 GenericCategory aufgelöst.
Wir verwenden die Felder category und categories, um Kategoriedaten abzurufen, die über das Feldargument taxonomy angeben, auf welche Taxonomie sie sich beziehen. Das Ergebnis ist vom Union-Typ CategoryUnion, der Einträge entweder aus PostCategory oder GenericCategory enthält (abhängig von der Taxonomie des Eintrags).
Die abfragbaren Kategorie-Taxonomien konfigurieren
Die Kategorie-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 anschließend die gewünschten Einträge auswählst:
Diese Liste enthält alle „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 sind. Die zugehörigen Custom Post Types jeder Kategorie-Taxonomie werden unter (CPT: ...) angezeigt. Falls deine gewünschte Kategorie-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 category taxonomies" auf der Einstellungsseite von Schema Custom Posts definiert ist:
Zusätzliche Konfiguration
Über die Einstellungen von Schema Categories können wir außerdem festlegen:
- Die Standardanzahl der abzurufenden Elemente (d. h. wenn das Feldargument
limitnicht gesetzt ist) bei der Abfrage einer Liste einer beliebigen Kategorie-Taxonomie - Die maximale Anzahl von Elementen, die in einer einzigen Query-Ausführung abgerufen werden können
