操作ガイドカスタムカテゴリー
カスタムカテゴリー
WordPressでは投稿にカテゴリーを追加できます(つまり、"category" という名前のタクソノミーを使用します)。これはすでに PostCategory 型 を通じてGraphQLスキーマにマップされており、Post エントリーに関連付けられています。
同様に、テーマやプラグインによって定義されたカスタム投稿タイプ(例:"product")には、独自のカテゴリータクソノミー(例:"product-cat")を関連付けることができます。これらのカスタム投稿タイプはGraphQLスキーマにマップされていないため、GenericCustomPost 型を通じて解決され、それらのカテゴリーは GenericCategory として解決されます。
カテゴリーデータを取得するには category フィールドと categories フィールドを使用し、フィールド引数 taxonomy によって参照するタクソノミーを指定します。結果はユニオン型 CategoryUnion となり、PostCategory または GenericCategory のいずれかのエントリーが含まれます(エントリーのタクソノミーによって異なります)。
たとえば、次のクエリはタクソノミー "product-category" のカテゴリーを取得します:
query {
categories(taxonomy: "product-category") {
__typename
...on Category {
count
description
id
name
slug
url
}
...on GenericCategory {
taxonomy
customPostCount
customPosts {
__typename
...on CustomPost {
id
title
}
}
}
}
}マップされていないカテゴリータクソノミーへのアクセスを許可する
GenericCategory 型を通じてアクセスできるカテゴリータクソノミーは、プラグインの設定ページで明示的に設定する必要があります。詳細はガイド カスタムカテゴリータクソノミーをスキーマに追加する を参照してください。