向 Schema 添加自定义分类法

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

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

我们使用 category 和 categories 字段来获取分类数据，通过字段参数 taxonomy 指定引用的分类法。结果为联合类型 CategoryUnion，其中包含来自 PostCategory 或 GenericCategory 的条目（取决于条目的分类法）。

​

配置可查询的分类法

可以被查询的分类法必须显式配置。这可以在两个地方完成。

在应用于端点的 Schema Configuration 中，在「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 category taxonomies」部分定义的值：

​

额外配置

通过 Schema Categories 的设置，我们还可以定义：

• 查询任意分类法列表时获取的默认元素数量（即未设置字段参数 limit 时）
• 单次查询执行中可获取的最大元素数量