WordPress Gutenberg 编辑器中的分类链接块使用指南

在 WordPress Gutenberg 编辑器中，导航菜单系统提供了多种类型的链接块，其中分类链接块(Category Link)的使用存在一些值得开发者注意的细节。本文将深入解析这一功能的技术实现和使用场景。

分类链接块的两种类型

Gutenberg 编辑器实际上提供了两种不同类型的分类链接块：

1. 标准分类链接块：图标由四个小方块组成，用于添加 WordPress 核心的分类(Category)项目到导航菜单中。

2. 自定义分类链接块：图标由星号和两条线组成，用于添加自定义分类法(taxonomy)的项目到导航菜单中。

技术实现原理

这两种分类链接块的差异源于 WordPress 的架构设计。WordPress 支持两种主要的内容分类方式：

• 内置分类法：如文章分类(Categories)和标签(Tags)
• 自定义分类法：通过 register_taxonomy() 函数注册

Gutenberg 编辑器会为每种分类法自动生成对应的导航链接块变体。当插件或主题注册了自定义分类法时，系统会自动在导航块插入器中显示额外的分类链接选项。

开发者注意事项

对于插件和主题开发者，可以通过在注册分类法时设置特定的标签属性来自定义链接块的显示名称：

register_taxonomy( 'my_custom_tax', 'post', array(
    'labels' => array(
        'item_link' => __('自定义分类链接', 'text-domain'),
        'item_link_description' => __('这是自定义分类法的描述', 'text-domain')
    )
    // 其他参数...
));

其中：

• item_link 控制链接块在插入器中显示的名称
• item_link_description 提供链接块的描述文本

最佳实践建议

1. 插件开发者：注册自定义分类法时，应当始终设置 item_link 和 item_link_description 标签，确保用户界面清晰易懂。

2. 主题开发者：在创建主题时，如果依赖自定义分类法，应当测试导航菜单中的分类链接块是否显示正确。

3. 内容编辑者：如果在导航菜单中看到多个分类链接选项，可以通过查看分类名称或测试添加项目来区分它们的功能。

常见问题排查

如果在使用过程中发现分类链接块显示异常，可以检查以下方面：

1. 确认是否有插件注册了自定义分类法
2. 检查自定义分类法的 show_in_rest 参数是否设置为 true
3. 查看分类法注册时是否提供了适当的标签设置

通过理解 Gutenberg 编辑器中分类链接块的工作原理，开发者和内容创作者可以更高效地构建 WordPress 网站的导航结构。