本教程详细介绍了如何利用 `woocommerce_is_purchasable` 过滤器，在WooCommerce中将一系列指定产品设置为不可购买。通过在PHP代码中定义一个产品ID数组，并结合 `in_array()` 函数，开发者可以精确控制哪些产品不能被添加到购物车，从而实现“联系我们”或定制销售流程，为商家提供灵活的产品销售管理能力。
概述：控制WooCommerce产品的可购买性
在WooCommerce商店运营中，有时我们需要阻止用户直接购买某些特定产品。这可能是出于多种原因，例如：产品需要定制报价、缺货但仍需展示、仅供展示而非销售，或者需要客户在购买前联系商家。WooCommerce提供了一个强大的过滤器 woocommerce_is_purchasable，允许开发者通过自定义PHP代码来控制任何产品的可购买状态。
本教程将指导您如何使用此过滤器，特别是如何针对多个产品ID实现这一功能，从而将它们设置为不可购买。
理解 woocommerce_is_purchasable 过滤器
woocommerce_is_purchasable 是一个WordPress/WooCommerce过滤器钩子，它在系统判断一个产品是否可以被添加到购物车时触发。它的定义如下：
立即学习“PHP免费学习笔记（深入）”；
apply_filters( 'woocommerce_is_purchasable', $is_purchasable, $this );
其中：
- $is_purchasable：一个布尔值，表示产品当前的默认可购买状态（true 或 false）。
- $this：当前正在检查的 WC_Product 对象。
通过这个过滤器，我们可以截获并修改 $is_purchasable 的值，从而改变产品的购买行为。
单个产品不可购买的实现（初始方法）
最初，如果只需要将一个产品设置为不可购买，可以使用如下代码：
/**
* 使单个WooCommerce产品不可购买。
*
* @param bool $is_purchasable 当前可购买状态。
* @param WC_Product $product 产品对象。
* @return bool
*/
add_filter('woocommerce_is_purchasable', 'my_single_product_not_purchasable', 10, 2);
function my_single_product_not_purchasable($is_purchasable, $product) {
// 假设产品ID为24的产品不可购买
if ($product->get_id() == 24) {
return false; // 如果是产品ID 24，则设置为不可购买
}
return $is_purchasable; // 否则，返回产品的原始可购买状态
}这段代码通过检查产品ID是否为 24 来决定其可购买性。如果匹配，则返回 false，表示该产品不可购买。对于其他产品，它会返回 $is_purchasable 的原始值。
然而，当需要将多个产品设置为不可购买时，这种方法会变得冗长且难以维护。
针对多个产品ID实现不可购买性
为了更高效地管理多个不可购买的产品，我们可以利用PHP数组来存储这些产品的ID，并使用 in_array() 函数来检查当前产品ID是否在列表中。
以下是实现这一功能的完整代码：
<?php
/**
* 使指定WooCommerce产品列表不可购买。
*
* 此函数通过 'woocommerce_is_purchasable' 过滤器，
* 检查当前产品是否在预定义的不可购买产品ID列表中。
* 如果是，则将产品设置为不可购买。
*
* @param bool $is_purchasable 当前产品的可购买状态。
* @param WC_Product $product WC_Product 产品对象。
* @return bool 返回修改后的可购买状态。
*/
add_filter('woocommerce_is_purchasable', 'my_custom_non_purchasable_products', 10, 2);
function my_custom_non_purchasable_products($is_purchasable, $product) {
// 定义一个包含所有不可购买产品ID的数组
// 请将以下示例ID替换为您实际需要设置为不可购买的产品ID
$non_purchasable_product_ids = array(
20, // 示例产品ID 1
21, // 示例产品ID 2
22, // 示例产品ID 3
23, // 示例产品ID 4
24, // 示例产品ID 5
25, // 您可以根据需要添加更多产品ID
26
);
// 检查当前产品的ID是否在不可购买产品列表中
if ( in_array( $product->get_id(), $non_purchasable_product_ids ) ) {
return false; // 如果产品ID在列表中，则设置为不可购买
}
// 如果产品ID不在列表中，则返回其原始的可购买状态
return $is_purchasable;
}代码解析
-
add_filter('woocommerce_is_purchasable', 'my_custom_non_purchasable_products', 10, 2);
- 这行代码将我们的自定义函数 my_custom_non_purchasable_products 挂载到 woocommerce_is_purchasable 过滤器上。
- 10 是优先级，表示在其他函数之前或之后运行（数字越小，优先级越高）。
- 2 表示我们的函数接受两个参数 ($is_purchasable 和 $product)。
-
function my_custom_non_purchasable_products($is_purchasable, $product)
- 这是我们的自定义回调函数，它接收当前的可购买状态和产品对象作为参数。
-
$non_purchasable_product_ids = array(20, 21, 22, 23, 24, 25, 26);
- 这是核心部分。您需要在此处列出所有您希望设置为不可购买的WooCommerce产品ID。请确保这些ID是正确的，并且用逗号分隔。
-
if ( in_array( $product-youjiankuohaophpcnget_id(), $non_purchasable_product_ids ) ) { ... }
- $product->get_id()：这是获取当前产品ID的标准方法（推荐使用 get_id() 而非 $product->id，因为后者可能在未来版本中被弃用）。
- in_array()：这是一个PHP内置函数，用于检查一个值是否存在于数组中。在这里，它检查当前产品的ID是否在 $non_purchasable_product_ids 数组中。
- 如果 in_array() 返回 true（即产品ID在列表中），则条件成立。
-
return false;
- 如果当前产品ID在 $non_purchasable_product_ids 数组中，我们强制将其可购买状态设置为 false。这意味着该产品将无法被添加到购物车。
-
return $is_purchasable;
- 如果当前产品ID不在不可购买列表中，我们不干预其状态，而是返回 $is_purchasable 的原始值。这样可以确保其他产品保持其默认的可购买行为。
代码放置位置
将上述PHP代码添加到您的WordPress网站的以下位置之一：
- 子主题的 functions.php 文件 (推荐): 这是最常见且最安全的方法。如果您使用的是第三方主题，创建一个子主题可以确保在主题更新时您的自定义代码不会丢失。
- 自定义插件: 如果您有多个自定义功能，或者希望此功能在更换主题后依然有效，创建一个轻量级的自定义插件是更好的选择。
重要提示：切勿直接修改父主题的 functions.php 文件，因为在主题更新时，您的所有更改都将被覆盖。
注意事项与最佳实践
- 产品ID准确性：确保您在 $non_purchasable_product_ids 数组中输入的产品ID是正确的。错误的ID将导致预期的产品仍然可购买，或者错误的产品变得不可购买。
- 用户体验：当产品不可购买时，WooCommerce通常会将“添加到购物车”按钮替换为“阅读更多”或自定义文本。请确保这种变化对您的用户来说是清晰和直观的。您还可以考虑添加一个自定义消息，解释产品为何不可购买以及如何联系您。
- 缓存：在实施此类代码更改后，请务必清除您的网站缓存（包括任何WordPress插件缓存、CDN缓存和服务器级缓存），以确保更改立即生效。
- 测试：在将代码部署到生产环境之前，务必在开发或 staging 环境中进行全面测试，以验证其功能是否符合预期。
- 可维护性：对于非常多的不可购买产品，或者需要动态管理列表的情况，可以考虑将产品ID存储在数据库选项中，而不是硬编码在数组里，这样更方便通过后台界面进行管理。
总结
通过利用 woocommerce_is_purchasable 过滤器和PHP的 in_array() 函数，您可以轻松地将多个WooCommerce产品设置为不可购买。这种方法提供了一种灵活且高效的方式来控制产品的销售流程，以满足特定的业务需求。遵循本教程中的步骤和最佳实践，您将能够成功地在您的WooCommerce商店中实现这一功能。
