本教程详细介绍了如何在woocommerce中实现基于配送方式的购物车结账限制。通过集成自定义代码，您可以设定当购物车中仅包含特定商品类别的产品时，默认禁止结账；但若用户选择了预设的特定配送方式（例如“到店自取”），则此限制将自动解除，允许用户完成购买。文章将提供完整的代码示例及详细解释，助您灵活控制商店的结账流程。
在WooCommerce商店运营中，有时需要根据特定的业务规则来调整用户的结账体验。例如，您可能希望强制顾客在购买某些特定类别的商品时，必须同时购买其他类别的商品才能结账，但对于某些特殊的配送方式（如“到店自取”），则可以放宽此限制。本文将指导您如何通过自定义代码实现这一高级功能。
核心功能概述
我们将通过两个主要函数来实现这一目标：
- sv_wc_prevent_checkout_for_category(): 此函数负责在购物车验证阶段（woocommerce_check_cart_items 钩子）触发逻辑，检查购物车内容是否满足限制条件，并在不满足时显示错误通知。
- sv_wc_is_category_alone_in_cart(): 这是一个辅助函数，用于判断购物车中是否仅包含指定类别的商品，并在此基础上加入对当前所选配送方式的判断。
实现步骤与代码示例
1. 设置商品类别结账限制的基础逻辑
首先，我们需要一个机制来识别购物车中是否仅包含特定类别的商品。以下代码实现了这一基础功能：
/**
* 检查购物车是否只包含特定类别的商品，并在满足条件时阻止结账。
*/
function sv_wc_prevent_checkout_for_category() {
// 设置需要限制的商品类别 slug
$category_slug = 'clothing'; // 请替换为您的商品类别 slug
// 获取商品类别对象
$product_cat = get_term_by( 'slug', $category_slug, 'product_cat' );
// 安全检查，防止类别不存在导致错误
if ( is_wp_error( $product_cat ) || ! $product_cat ) {
return;
}
// 构建类别名称链接，用于错误消息
$category_name = '<a href="' . esc_url( get_term_link( $category_slug, 'product_cat' ) ) . '">' . esc_html( $product_cat->name ) . '</a>';
// 检查购物车中是否仅包含此类别商品
if ( sv_wc_is_category_alone_in_cart( $category_slug ) ) {
// 如果是，则显示错误通知，阻止结账
wc_add_notice( sprintf(
'您好！您的购物车目前只包含来自 %1$s 类别的商品 – 您必须添加其他类别的商品才能结账。',
$category_name
), 'error' );
}
}
add_action( 'woocommerce_check_cart_items', 'sv_wc_prevent_checkout_for_category' );
/**
* 辅助函数：判断购物车中是否所有商品都属于指定类别。
*
* @param string $category_slug 商品类别 slug。
* @return bool 如果所有商品都属于指定类别，则返回 true；否则返回 false。
*/
function sv_wc_is_category_alone_in_cart( $category_slug ) {
// 遍历购物车中的每个商品
foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
// 如果发现有任何商品不属于指定类别，则说明该类别并非单独存在，立即返回 false
if ( ! has_term( $category_slug, 'product_cat', $cart_item['product_id'] ) ) {
return false;
}
}
// 如果遍历完所有商品都没有返回 false，则表示所有商品都属于指定类别
return true;
}代码解释：
- sv_wc_prevent_checkout_for_category() 函数通过 woocommerce_check_cart_items 钩子在购物车内容被检查时执行。
- 它首先定义了需要限制的商品类别 $category_slug（请务必替换为您的实际类别 slug）。
- 然后调用 sv_wc_is_category_alone_in_cart() 来判断购物车内容。
- 如果判断结果为 true（即购物车中只包含该类别商品），则使用 wc_add_notice() 显示一个错误消息，阻止用户结账。
- sv_wc_is_category_alone_in_cart() 函数遍历购物车中的所有商品，使用 has_term() 函数检查每个商品是否属于指定的类别。只要有一个商品不属于该类别，就立即返回 false。
2. 整合配送方式条件
现在，我们将引入配送方式的判断逻辑。目标是：如果用户选择了特定的配送方式（例如“到店自取”），即使购物车中只包含限制类别的商品，也允许结账。
要获取当前选择的配送方式，我们可以使用 WC()->session->get('chosen_shipping_methods')[0]。这个方法会返回一个数组，其中第一个元素就是当前选中的配送方式ID。
我们将修改 sv_wc_is_category_alone_in_cart() 函数，在开始时加入对配送方式的判断：
/**
* 辅助函数：判断购物车中是否所有商品都属于指定类别，并考虑配送方式。
*
* @param string $category_slug 商品类别 slug。
* @return bool 如果所有商品都属于指定类别且配送方式不符合豁免条件，则返回 true；否则返回 false。
*/
function sv_wc_is_category_alone_in_cart( $category_slug ) {
// 获取当前选择的配送方式
$chosen_shipping_methods = WC()->session->get('chosen_shipping_methods');
$current_shipping_method_id = isset($chosen_shipping_methods[0]) ? $chosen_shipping_methods[0] : '';
// 定义豁免此限制的配送方式ID
// 示例：'local_pickup:8' 是一个到店自取方式的ID。
// 您需要替换为您的实际配送方式ID。
$exempt_shipping_method_id = 'local_pickup:8';
// 如果当前选择的配送方式是豁免方式，则直接返回 false，表示不触发类别限制
if ( $current_shipping_method_id === $exempt_shipping_method_id ) {
return false; // 允许结账，不应用类别限制
}
// 遍历购物车中的每个商品
foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
// 如果发现有任何商品不属于指定类别，则说明该类别并非单独存在，立即返回 false
if ( ! has_term( $category_slug, 'product_cat', $cart_item['product_id'] ) ) {
return false;
}
}
// 如果遍历完所有商品都没有返回 false，且配送方式不是豁免方式，
// 则表示所有商品都属于指定类别，并且需要应用限制
return true;
}关键修改点：
- 在 sv_wc_is_category_alone_in_cart() 函数的开头，我们首先获取当前选中的配送方式ID。
- 定义了一个 $exempt_shipping_method_id 变量，用于存储您希望豁免此限制的配送方式ID。
- 通过 if ( $current_shipping_method_id === $exempt_shipping_method_id ) 判断，如果当前选择的配送方式是豁免方式，函数会立即返回 false。这意味着 sv_wc_prevent_checkout_for_category() 函数中的 if 条件将不会满足，从而不会显示错误通知，允许用户结账。
3. 完整代码示例
将上述两个部分的逻辑整合到您的WordPress环境中（通常是子主题的 functions.php 文件或自定义插件中）。
<?php
/**
* WooCommerce：根据配送方式动态调整购物车结账限制
*
* 此代码段用于实现一个功能：
* 当购物车中仅包含特定商品类别的商品时，默认阻止结账。
* 但如果用户选择了特定的配送方式（例如“到店自取”），则此限制将被豁免。
*/
/**
* 检查购物车是否只包含特定类别的商品，并在满足条件时阻止结账。
* 同时，如果选择了豁免的配送方式，则不触发此限制。
*/
function sv_wc_prevent_checkout_for_category() {
// 设置需要限制的商品类别 slug
// 请将 'test-1' 替换为您实际的商品类别 slug
$category_slug = 'test-1';
// 获取商品类别对象
$product_cat = get_term_by( 'slug', $category_slug, 'product_cat' );
// 安全检查，防止类别不存在导致错误
if ( is_wp_error( $product_cat ) || ! $product_cat ) {
return;
}
// 构建类别名称链接，用于错误消息
$category_name = '<a href="' . esc_url( get_term_link( $category_slug, 'product_cat' ) ) . '">' . esc_html( $product_cat->name ) . '</a>';
// 检查购物车中是否仅包含此类别商品，并考虑配送方式
if ( sv_wc_is_category_alone_in_cart( $category_slug ) ) {
// 如果是，则显示错误通知，阻止结账
wc_add_notice( sprintf(
'您好！您的购物车目前只包含来自 %1$s 类别的商品 – 您必须添加其他类别的商品才能结账。',
$category_name
), 'error' );
}
}
add_action( 'woocommerce_check_cart_items', 'sv_wc_prevent_checkout_for_category' );
/**
* 辅助函数：判断购物车中是否所有商品都属于指定类别，并考虑配送方式。
*
* @param string $category_slug 商品类别 slug。
* @return bool 如果所有商品都属于指定类别且配送方式不符合豁免条件，则返回 true；否则返回 false。
*/
function sv_wc_is_category_alone_in_cart( $category_slug ) {
// 获取当前选择的配送方式
$chosen_shipping_methods = WC()->session->get('chosen_shipping_methods');
$current_shipping_method_id = isset($chosen_shipping_methods[0]) ? $chosen_shipping_methods[0] : '';
// 定义豁免此限制的配送方式ID
// 示例：'local_pickup:8' 是一个到店自取方式的ID。
// 您需要替换为您的实际配送方式ID。
// 如何找到配送方式ID：
// 1. 在结账页面选择该配送方式。
// 2. 检查浏览器开发者工具的网络请求，或者在代码中打印 `WC()->session->get('chosen_shipping_methods')`。
// 3. 对于“到店自取”通常是 'local_pickup:ZONE_ID'，其中 ZONE_ID 是您设置的配送区域ID。
$exempt_shipping_method_id = 'local_pickup:8';
// 如果当前选择的配送方式是豁免方式，则直接返回 false，表示不触发类别限制
if ( $current_shipping_method_id === $exempt_shipping_method_id ) {
return false; // 允许结账，不应用类别限制
}
// 遍历购物车中的每个商品
foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
// 确保产品数据存在
if ( ! isset( $cart_item['product_id'] ) ) {
continue;
}
// 如果发现有任何商品不属于指定类别，则说明该类别并非单独存在，立即返回 false
if ( ! has_term( $category_slug, 'product_cat', $cart_item['product_id'] ) ) {
return false;
}
}
// 如果遍历完所有商品都没有返回 false，且配送方式不是豁免方式，
// 则表示所有商品都属于指定类别，并且需要应用限制
return true;
}注意事项与最佳实践
-
替换占位符：
- 务必将 $category_slug = 'test-1'; 中的 'test-1' 替换为您要限制的商品类别 slug。
- 务必将 $exempt_shipping_method_id = 'local_pickup:8'; 中的 'local_pickup:8' 替换为您希望豁免此限制的实际配送方式ID。
- 查找配送方式ID：
-
代码放置位置：
- 将上述代码添加到您WordPress网站的子主题的 functions.php 文件中。不建议直接修改父主题文件，因为主题更新会覆盖您的更改。
- 或者，您可以创建一个自定义插件来包含此功能，这样更易于管理和更新。
-
测试：
- 在部署到生产环境之前，务必在开发或测试环境中进行彻底测试，确保所有场景（只包含限制类别、包含其他类别、选择豁免配送方式、选择非豁免配送方式等）都按预期工作。
-
用户体验：
- 确保错误消息清晰明了，指导用户如何操作才能完成结账。
总结
通过上述教程，您已经成功地为WooCommerce商店实现了一个高级的条件结账逻辑，即根据用户选择的配送方式来动态调整商品类别的结账限制。这种灵活性有助于您更好地管理复杂的业务规则，提升用户体验，并确保订单的合规性。请根据您的具体需求调整代码中的商品类别 slug 和配送方式 ID，以确保功能正确运行。
