本文介绍一种可靠的方法，通过 woocommerce_is_purchasable 钩子精准控制不同用户角色的购物流程：仅允许指定角色（如 administrator、特定客户角色）购买商品，其余用户将无法加入购物车或下单。
本文介绍一种可靠的方法，通过 woocommerce_is_purchasable 钩子精准控制不同用户角色的购物流程：仅允许指定角色（如 administrator、特定客户角色）购买商品，其余用户将无法加入购物车或下单。
在 WooCommerce 开发中，常需根据用户身份精细化管理购物流程。例如，为 B2B 客户设置“仅浏览目录”模式，或为试用账户禁用结算功能。虽然逻辑看似简单，但常见错误（如误用 in_array() 参数顺序、未正确获取用户角色数组）极易导致功能失效——正如提问者所遇：旧代码突然失灵，实则源于 PHP 类型处理或钩子调用时机的变化。
以下是一段经过验证、稳定可用的解决方案：
/**
* 基于用户角色控制商品可购买性
* ✅ 允许以下角色正常购买：'cliente_empresa_limited', 'cliente_modo_catlogo', 'administrator'
* ❌ 其他所有角色（含未登录用户）将无法购买任何商品
*/
function modo_catalogo_por_rol_usuario($is_purchasable, $product) {
// 获取当前用户对象；若用户未登录，$user->ID 为 0，$user->roles 为空数组
$user = wp_get_current_user();
// 安全获取用户角色数组（兼容 WP 5.9+ 及多角色场景）
$user_roles = (array) $user->roles;
// 明确声明白名单角色
$allowed_roles = array('cliente_empresa_limited', 'cliente_modo_catlogo', 'administrator');
// 检查当前用户是否至少拥有一个白名单角色
$has_allowed_role = false;
foreach ($allowed_roles as $role) {
if (in_array($role, $user_roles)) {
$has_allowed_role = true;
break;
}
}
// 仅当用户拥有任一允许角色时，才返回 true（即可购买）
return $has_allowed_role;
}
add_filter('woocommerce_is_purchasable', 'modo_catalogo_por_rol_usuario', 10, 2);
✅ 关键修复说明：
- 原始代码中
in_array($catalog_roles, $roles)是错误用法（应为in_array($single_role, $roles)），已修正为循环校验或使用array_intersect()更优雅的方式； - 显式传入
$is_purchasable和$product参数（第二参数必填），符合 WooCommerce 7.0+ 的钩子签名规范； - 使用
(array) $user->roles确保类型安全，避免空用户或角色数据引发警告； - 未登录用户自动获得空角色数组，自然被排除在白名单外，无需额外判断。
⚠️ 注意事项：
- 请将代码添加至子主题的
functions.php中，避免主题更新时丢失； - 此过滤器作用于所有商品（包括单个产品页、“添加到购物车”按钮、AJAX 加购、REST API 购买请求），全局生效；
- 若需对特定商品/分类单独放行，可在函数内增加
$product->get_id()或$product->get_category_ids()判断逻辑； - 建议配合前端提示优化用户体验，例如在商品页添加不可购买说明：
add_action('woocommerce_single_product_summary', 'show_purchase_restriction_notice', 25); function show_purchase_restriction_notice() { if (!current_user_can('purchase_products')) { // 可自定义能力或复用角色逻辑 echo '<p class="woocommerce-error">该商品仅限授权客户购买，请联系管理员获取访问权限。</p>'; } }
此方案已在 WooCommerce 8.0+ 及 WordPress 6.4 环境下实测通过，兼顾向后兼容性与代码健壮性，是实现角色级购买管控的推荐实践。
