カスタムタグタクソノミーをスキーマに追加する

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

テーマやプラグインで定義されたカスタム投稿タイプ（例："product"）も、独自のタグタクソノミー（例："product-tag"）を関連付けることができます。これらのタグタクソノミーは GraphQL スキーマ専用の型を持たないため（それには PHP コードによる拡張が必要です）、GenericTag 型を通じて解決されます。

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

​

クエリ可能なタグタクソノミーの設定

クエリ可能なタグタクソノミーは明示的に設定する必要があります。設定は2か所で行うことができます。

エンドポイントに適用されるスキーマ設定において、「Customize configuration, or use default from Settings?」の下にある "Use custom configuration" オプションを選択し、次に希望するアイテムを選択します。

このリストには、クエリ可能なカスタム投稿に関連付けられたすべての「非階層的」タクソノミーが含まれます。つまり、「Custom Posts」の設定にある「Included custom post types」で選択されたものです。各タグタクソノミーに関連付けられたカスタム投稿タイプは (CPT: ...) の下に表示されます。希望するタグタクソノミーが表示されない場合は、関連するすべてのカスタム投稿タイプがその許可リストに含まれていることを確認してください。

"Use configuration from Settings" オプションを選択した場合は、Schema Custom Posts の設定ページにある「Included tag taxonomies」セクションで定義された値が使用されます。

​

追加設定

Schema Tags の設定を通じて、以下の項目も定義できます。

• タグタクソノミーのリストをクエリする際に取得する要素のデフォルト数（つまり、フィールド引数 limit が設定されていない場合）
• 1回のクエリ実行で取得できる要素の最大数