本文详细介绍了如何在woocommerce中利用`woocommerce_is_purchasable`过滤器，通过php代码批量控制特定商品的购买权限。通过构建一个包含多个商品id的数组，并结合`in_array()`函数，开发者可以灵活地设置哪些商品不可被添加到购物车或直接购买，从而实现对商品销售策略的精细化管理，适用于需要限制部分商品销售的场景。
理解 woocommerce_is_purchasable 过滤器
在WooCommerce中，woocommerce_is_purchasable 是一个核心过滤器，它决定了商品是否可以被添加到购物车或直接购买。通过修改这个过滤器的返回值，我们可以实现对商品购买状态的自定义控制。
过滤器签名：
apply_filters( 'woocommerce_is_purchasable', bool $is_purchasable, WC_Product $product )
- $is_purchasable (布尔值): 当前商品是否可购买的状态。
- $product (WC_Product 对象): 当前正在检查的商品对象。
此过滤器期望返回一个布尔值：true 表示商品可购买，false 表示商品不可购买。
单个商品购买限制的局限性
最初，如果只需要限制单个商品的购买，可能会采用以下方式：
立即学习“PHP免费学习笔记（深入）”；
add_filter('woocommerce_is_purchasable', 'my_single_product_restriction', 10, 2);
function my_single_product_restriction($is_purchasable, $product) {
// 假设商品ID为24的商品不可购买
if ($product->get_id() == 24) {
return false;
}
return $is_purchasable;
}这种方法对于限制一个或少数几个商品是有效的。然而，当需要限制的商品数量增多时，代码会变得冗长且难以维护，每次新增或移除限制商品都需要修改条件判断语句。
批量管理商品购买限制
为了高效地管理多个商品的购买限制，我们可以利用PHP数组和in_array()函数。这种方法允许我们将所有需要限制的商品ID集中存放在一个数组中，然后通过检查当前商品ID是否在该数组中来决定其购买状态。
实现步骤
- 定义限制商品ID数组： 创建一个PHP数组，其中包含所有你希望设置为不可购买的商品ID。
- 使用 in_array() 函数： 在过滤器回调函数中，使用in_array()函数检查当前商品的ID是否在上述数组中。
- 返回相应的布尔值： 如果商品ID在限制数组中，则返回false（不可购买）；否则，返回原始的$is_purchasable状态。
示例代码
将以下代码添加到你的WordPress主题的functions.php文件或自定义插件中：
/**
* 批量限制WooCommerce商品的购买权限
*
* @param bool $is_purchasable 当前商品的购买状态
* @param WC_Product $product 当前的WC_Product对象
* @return bool 修改后的商品购买状态
*/
add_filter('woocommerce_is_purchasable', 'my_batch_product_purchasability_restriction', 10, 2);
function my_batch_product_purchasability_restriction($is_purchasable, $product) {
// 定义需要限制购买的商品ID列表
// 请根据实际情况修改这些ID
$restricted_product_ids = array(20, 21, 22, 23, 24, 30, 35, 42);
// 获取当前商品的ID
$current_product_id = $product->get_id();
// 检查当前商品ID是否在限制列表中
if (in_array($current_product_id, $restricted_product_ids)) {
// 如果商品ID在限制列表中，则设置为不可购买
return false;
}
// 否则，保持原有的购买状态
return $is_purchasable;
}代码解析：
- add_filter('woocommerce_is_purchasable', 'my_batch_product_purchasability_restriction', 10, 2);：注册我们的自定义函数到woocommerce_is_purchasable过滤器。优先级为10，接受2个参数。
- $restricted_product_ids = array(20, 21, 22, 23, 24, 30, 35, 42);：这是核心，你可以在这里列出所有你希望禁用购买功能的商品ID。
- $current_product_id = $product->get_id();：推荐使用get_id()方法获取商品ID，而非直接访问$product->id属性，这在WooCommerce新版本中是更健壮的做法。
- if (in_array($current_product_id, $restricted_product_ids))：in_array()函数会检查$current_product_id是否存在于$restricted_product_ids数组中。
- return false;：如果商品ID在限制列表中，函数返回false，WooCommerce会将其视为不可购买。
- return $is_purchasable;：如果商品ID不在限制列表中，函数返回原始的$is_purchasable值，即不改变其购买状态。
注意事项与最佳实践
- 代码位置： 建议将此代码放置在子主题的functions.php文件中，或创建一个自定义插件来管理此类功能。直接修改父主题文件可能在主题更新时丢失更改。
- 商品ID获取： 你可以在WordPress后台编辑商品页面时，从URL中找到商品ID，或者在商品列表中将鼠标悬停在商品标题上查看。
- 用户体验： 当商品不可购买时，WooCommerce通常会显示“阅读更多”按钮而不是“加入购物车”按钮。你可能需要考虑在商品页面添加额外的说明，告知用户为何该商品不可购买，或提供替代联系方式。
- 性能考量： 对于包含成千上万个ID的$restricted_product_ids数组，in_array()的性能可能会略有下降。对于极大规模的列表，可以考虑使用哈希表（关联数组）或数据库查询来优化查找效率，但这对于大多数电商网站来说不是问题。
- 多用途： 除了禁用购买，你还可以扩展此逻辑，例如在特定条件下改变商品价格、库存状态等，但那需要使用不同的WooCommerce过滤器。
总结
通过利用woocommerce_is_purchasable过滤器和PHP的数组操作，我们可以轻松实现对WooCommerce中多个商品购买状态的批量管理。这种方法不仅代码简洁高效，而且易于维护和扩展，为电商网站提供了更灵活的商品销售控制能力。无论是出于供应商限制、预售咨询还是其他业务需求，此教程提供的方法都能有效帮助你实现目标。
