将自定义标签分类法添加到 Schema

在 WordPress 中，我们可以为文章添加标签（即使用名为 "post_tag" 的分类法）。这已经通过 PostTag 映射到 GraphQL schema 中，并与 Post 条目相关联。

由任何主题或插件定义的自定义文章类型（例如 "product"）同样可以关联其自己的标签分类法（例如 "product-tag"）。由于这些标签分类法没有专属的 GraphQL schema 类型（这需要通过 PHP 代码进行扩展），它们通过 GenericTag 类型来解析。

我们使用 tag 和 tags 字段获取标签数据，通过字段参数 taxonomy 指定所引用的分类法。结果为联合类型 TagUnion，根据条目的分类法，包含来自 PostTag 或 GenericTag 的条目。

​

配置可查询的标签分类法

可以查询的标签分类法必须明确配置。可以在以下 2 个地方进行配置。

在应用于端点的 Schema 配置中，在「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 时）
• 单次 query 执行中可获取的最大元素数量