操作ガイド
操作ガイドカスタムタグ

カスタムタグ

WordPress では投稿にタグを追加できます(つまり、"post_tag" という名前のタクソノミーを使用します)。これはすでに GraphQL スキーマで PostTag タイプ を通じてマッピングされており、Post エントリに関連付けられています。

同様に、テーマやプラグインによって定義されるカスタム投稿タイプ(例:"product")には、独自のタクソノミータグ(例:"product-cat")を関連付けることができます。これらのカスタム投稿タイプは GraphQL スキーマにマッピングされていないため、GenericCustomPost タイプで解決され、それらのタグは GenericTag として解決されます。

タグデータを取得するには tag フィールドと tags フィールドを使用し、フィールド引数 taxonomy でどのタクソノミーを参照するかを指定します。結果はユニオン型 TagUnion であり、エントリのタクソノミーに応じて PostTag または GenericTag のエントリが含まれます。

たとえば、次のクエリはタクソノミー "product-tag" のタグを取得します:

query {
  tags(taxonomy: "product-tag") {
    __typename
 
    ...on Tag {
      count
      description
      id
      name
      slug
      url
    }
    
    ...on GenericTag {
      taxonomy   
      customPostCount
      customPosts {
        __typename
        ...on CustomPost {
          id
          title
        }
      }
    }
  }
}

マッピングされていないタグタクソノミーへのアクセスを許可する

GenericTag タイプを通じてアクセス可能なタグタクソノミーは、ガイド カスタムタグタクソノミーをスキーマに追加する で説明されているように、プラグインの設定ページで明示的に設定する必要があります。