Mengonfigurasi plugin
Mengonfigurasi pluginMenambahkan taksonomi tag kustom ke skema

Menambahkan taksonomi tag kustom ke skema

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

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

Kita menggunakan field tag dan tags untuk mengambil data tag, yang menunjukkan taksonomi mana yang dirujuk melalui argumen field taxonomy. Hasilnya adalah tipe union TagUnion, yang mencakup entri dari PostTag atau GenericTag (tergantung pada taksonomi entri tersebut).

Tipe TagUnion

Mengonfigurasi taksonomi tag yang dapat di-query

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

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

Memilih taksonomi tag yang diizinkan dalam Schema Configuration

Daftar ini berisi semua taksonomi "non-hierarkis" yang terkait dengan custom post yang dapat di-query, yaitu yang dipilih dalam "Included custom post types" di Settings untuk "Custom Posts". Custom post types yang terkait dengan setiap taksonomi tag ditampilkan di bawah (CPT: ...). Jika taksonomi tag 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 didefinisikan di bagian "Included tag taxonomies" dalam halaman Settings untuk Schema Custom Posts akan digunakan:

Memilih taksonomi tag yang diizinkan dalam Settings
Memilih taksonomi tag yang diizinkan dalam Settings

Konfigurasi tambahan

Melalui Settings untuk Schema Tags, kita juga dapat mendefinisikan:

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