操作ガイド
操作ガイドカスタムカテゴリー

カスタムカテゴリー

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 型を通じてアクセスできるカテゴリータクソノミーは、プラグインの設定ページで明示的に設定する必要があります。詳細はガイド カスタムカテゴリータクソノミーをスキーマに追加する を参照してください。