WordPress 5.8.1中WooCommerce Product Categories List小工具在Legacy Widget列表缺失问题问询

常见触发原因 #

• WooCommerce版本不兼容：不同版本的WooCommerce对WordPress 5.8+区块小工具编辑器的适配逻辑存在差异，若故障站点与正常站点的WooCommerce版本不一致，可能出现旧版小工具未被正常注册到Legacy Widget列表的情况，优先核对两个站点的WooCommerce版本是否完全匹配。
• 小工具被主动注销：部分主题、自定义代码片段、第三方功能插件可能通过unregister_widget()函数主动注销了WooCommerce的旧版产品分类列表小工具，也有可能通过钩子关闭了Legacy Widget分类的加载逻辑。
• 旧版小工具支持被禁用：WordPress 5.8+默认加载Legacy Widget支持，若站点添加过禁用旧版小工具的自定义代码，或是安装的小工具管理类插件关闭了旧版小工具入口，也会导致对应选项消失。

可落地的修复步骤 #

• 排查冲突项：先将故障站点临时切换为WordPress默认主题（如Twenty Twenty-One），再逐一禁用除WooCommerce之外的所有插件，每操作一步就刷新小工具页面查看Legacy Widget列表是否恢复目标小工具，即可定位到引发冲突的主题或插件。
• 手动注册小工具：若排查无冲突，可在当前站点活跃主题的functions.php文件中添加如下代码，强制注册该小工具：

add_action( 'widgets_init', function() {
    register_widget( 'WC_Widget_Product_Categories' );
}, 99 );

• 回退经典小工具模式：若上述方案无效，可安装Classic Widgets插件切换回旧版小工具编辑器，该模式下会直接加载所有已注册的旧版小工具，无需通过Legacy Widget分类查找。

内容的提问来源于stack exchange，提问作者Nuno Marques