本文提供经过验证的 WordPress 代码方案，通过 woocommerce_is_purchasable 钩子精准控制不同用户角色的购买权限，修复原代码中因逻辑错误（如 in_array 参数顺序颠倒）和状态重置导致的失效问题。
本文提供经过验证的 wordpress 代码方案，通过 `woocommerce_is_purchasable` 钩子精准控制不同用户角色的购买权限，修复原代码中因逻辑错误（如 `in_array` 参数顺序颠倒）和状态重置导致的失效问题。
在 WooCommerce 中，根据用户角色动态控制商品是否可购买（即隐藏“加入购物车”按钮、禁用结算流程），是企业级电商场景中的常见需求——例如为 B2B 客户启用目录模式（仅浏览不可购），或为测试账号禁用下单功能。但许多开发者会遇到代码看似正确却始终不生效的问题，根源往往在于钩子逻辑误用或用户角色判断方式有误。
原始代码存在两个关键缺陷：
-
in_array($catalog_roles, $roles)参数顺序错误：应为in_array($role_to_check, $roles)，而原写法将整个数组作为搜索值，必然返回false； -
强制重置
$is_purchasable = true：无论用户角色如何，都先设为true，再尝试覆盖，导致非目标角色仍可购买。
以下是修正后的完整解决方案，已通过 WooCommerce 8.x + WordPress 6.x 环境实测：
/**
* 基于用户角色控制商品购买权限
* ✅ 允许以下角色正常购买：'cliente_empresa_limited', 'cliente_modo_catlogo', 'administrator'
* ❌ 其他所有角色（如 subscriber、customer 等）将无法购买（商品显示为“不可购买”）
*/
function modo_catalogo_por_rol_usuario($is_purchasable, $product) {
// 获取当前登录用户
$user = wp_get_current_user();
// 若用户未登录，保留默认购买状态（通常为 true），避免影响访客
if ($user->ID === 0) {
return $is_purchasable;
}
// 安全获取用户角色数组（兼容多角色）
$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;
}
}
// 仅当用户拥有白名单角色时才允许购买
return $has_allowed_role;
}
add_filter('woocommerce_is_purchasable', 'modo_catalogo_por_rol_usuario', 10, 2);
? 使用说明与注意事项：
- 将代码粘贴至子主题的
functions.php文件末尾（强烈建议使用子主题，避免主题更新丢失修改）； - 如需扩展允许角色，只需在
$allowed_roles数组中添加新角色 slug（如'wholesale_customer'）； - 该过滤器作用于所有商品（包括单个商品页、商品列表页、AJAX 加购等），无需额外处理；
- 对未登录用户默认放行（保留
$is_purchasable原值），如需禁止游客购买，请移除if ($user->ID === 0)判断并统一返回false； - 配合前端优化：可追加 CSS 隐藏不可购商品的加购按钮（如
.product:not(.purchasable) .single_add_to_cart_button { display: none; }），提升用户体验。
✅ 此方案采用标准 WooCommerce 钩子，无兼容性风险，且逻辑清晰、易于维护。部署后，目标受限角色用户访问商品页时，“加入购物车”按钮将自动消失，商品摘要区显示“此商品目前不可购买”，彻底阻断下单路径。
