WC Vendors 插件卸载后彻底清理残留数据+一键清理脚本

如果你曾经使用过 WC Vendors 或 WC Vendors Pro 插件，在 WordPress 中创建了商家/供应商角色，但后来决定停用并删除插件，你可能会发现：

• 插件停用后，后台仍然存在 vendor、vendor_staff 等用户角色；
• 数据库中可能残留一些插件专用的表和选项；
• usermeta 中可能还有 WC Vendors 的数据。

这会导致 WordPress 后台“脏乱”，甚至影响新插件或社区功能的管理。本文将手把手教你 如何彻底清理 WC Vendors 的角色和数据。

注意：在做任何修改前请务必提前做好数据备份的工作！修改完成后仔细检查是否对网站有不良影响，如有问题请立刻恢复备份数据，并反馈！

一、WC Vendors 插件常见的用户角色

根据插件版本的不同，WC Vendors 会创建以下用户角色：

注意：即使删除了插件，用户角色不会自动移除，需要手动删除。

二、手动删除用户角色

可以通过在主题的 functions.php 或自定义插件里添加以下代码来删除角色：

function remove_wc_vendors_all_roles() {
    remove_role( 'vendor' );
    remove_role( 'pending_vendor' );
    remove_role( 'vendor_staff' );
    remove_role( 'rejected_vendor' ); // 有些版本存在
}
add_action( 'init', 'remove_wc_vendors_all_roles' );

• 执行一次后刷新后台，相关角色会彻底被删除。
• 执行完成后可以删除或注释掉这段代码，避免重复调用。

三、清理数据库残留

1. 数据表

WC Vendors / WC Vendors Pro 可能创建的表：

• wp_wcv_commissions（佣金结算表）
• wp_wcv_commission_meta（佣金元数据）
• wp_wcv_shipping_zone_methods（运费设置）
• wp_wcv_shipping_zone_locations

在 phpMyAdmin 或命令行中执行以下 SQL 语句删除：

DROP TABLE IF EXISTS wp_wcv_commissions;
DROP TABLE IF EXISTS wp_wcv_commission_meta;
DROP TABLE IF EXISTS wp_wcv_shipping_zone_methods;
DROP TABLE IF EXISTS wp_wcv_shipping_zone_locations;

注意：wp_ 为表前缀，如果你的 WordPress 使用了其他前缀，请修改对应前缀。

2. Options 残留

插件在 wp_options 表中会留下设置数据，通常以 wcv_ 或 wc_vendors_ 开头。删除方法：

DELETE FROM wp_options WHERE option_name LIKE 'wcv_%';
DELETE FROM wp_options WHERE option_name LIKE 'wc_vendors_%';

3. Usermeta 残留

商家角色的用户可能在 wp_usermeta 中有插件特定数据，删除方法：

DELETE FROM wp_usermeta WHERE meta_key LIKE 'wcv_%';
DELETE FROM wp_usermeta WHERE meta_key LIKE 'wc_vendors_%';

⚠️ 注意：如果你站点上还使用其他多商家插件，请确认不要误删有效数据。

四、总结完整清理步骤

1. 删除 WC Vendors 用户角色：vendor、pending_vendor、vendor_staff、rejected_vendor。
2. 删除插件创建的数据表：wp_wcv_* 系列表。
3. 删除 wp_options 残留设置：wcv_% 和 wc_vendors_% 开头的选项。
4. 删除 wp_usermeta 残留数据：wcv_% 和 wc_vendors_% 开头的 usermeta。

执行以上步骤后，你的 WordPress 将彻底清理 WC Vendors 的所有残留数据，为后续插件或社区系统打下干净基础。

一键清理脚本

如果需要一键清理脚本，可以评论后免费查看哦。