Menambahkan taksonomi kategori kustom ke skema

Kita dapat menambahkan kategori ke postingan di WordPress (yaitu menggunakan taksonomi dengan nama "category"). Ini sudah dipetakan dalam skema GraphQL melalui PostCategory, yang terkait dengan entri Post.

Custom Post Types yang didefinisikan oleh tema atau plugin apa pun (seperti "product") juga dapat memiliki taksonomi kategori sendiri yang terkait dengannya (seperti "product-cat"). Karena taksonomi kategori ini tidak menyertakan tipe spesifik sendiri untuk skema GraphQL (yang memerlukan ekstensi melalui kode PHP), taksonomi ini diselesaikan melalui tipe GenericCategory.

Kita menggunakan field category dan categories untuk mengambil data kategori, yang menunjukkan taksonomi mana yang dirujuk melalui argumen field taxonomy. Hasilnya bertipe union CategoryUnion, yang mencakup entri dari PostCategory maupun GenericCategory (bergantung pada taksonomi entri tersebut).

​

Mengonfigurasi taksonomi kategori yang dapat di-query

Taksonomi kategori yang dapat di-query harus dikonfigurasi secara eksplisit. Ini dapat dilakukan di 2 tempat.

Dalam Konfigurasi Skema yang diterapkan pada endpoint, dengan memilih opsi "Use custom configuration" di bawah "Customize configuration, or use default from Settings?" lalu memilih item yang diinginkan:

Daftar ini berisi semua taksonomi "hierarkis" yang terkait dengan custom post yang dapat di-query, yaitu yang dipilih di "Included custom post types" dalam Settings untuk "Custom Posts". Jenis custom post yang terkait dengan setiap taksonomi kategori ditampilkan di bawah (CPT: ...). Jika taksonomi kategori yang Anda inginkan tidak muncul di sini, pastikan semua custom post types yang terkait dengannya ada dalam daftar yang diizinkan tersebut.

Jika tidak, jika memilih opsi "Use configuration from Settings", nilai yang ditentukan di bagian "Included category taxonomies" pada halaman Settings untuk Schema Custom Posts akan digunakan:

​

Konfigurasi tambahan

Melalui Settings untuk Schema Categories, kita juga dapat mendefinisikan:

• Jumlah default elemen yang diambil (yaitu ketika argumen field limit tidak diatur) saat melakukan query untuk daftar taksonomi kategori apa pun
• Jumlah maksimum elemen yang dapat diambil dalam satu eksekusi query