WooCommerce 高级教程：结合配送方式控制商品分类结账逻辑

本文详细介绍了如何在 woocommerce 中实现条件式结账限制。具体来说，它解释了如何防止客户在购物车中仅包含特定类别商品时进行结账，但此限制仅在未选择特定配送方式（例如“门店自提”）时生效。这涉及到利用 woocommerce 会话数据动态检查所选配送方式，并将其与现有的基于商品分类的购物车验证逻辑相结合。

在电子商务运营中，有时需要根据特定的业务规则限制用户的结账行为。WooCommerce 提供了强大的扩展能力来满足这些定制化需求。本教程将深入探讨如何实现一个高级的条件结账逻辑：当购物车中仅包含特定商品分类的商品时阻止结账，但这一限制仅在用户选择非指定配送方式时才生效。例如，您可以设置当购物车中只有“服装”类商品且用户未选择“门店自提”时，才阻止其结账。

理解基于商品分类的结账限制

首先，我们来看一个常见的场景：阻止用户仅购买特定分类的商品。以下代码片段展示了如何实现当购物车中只有特定分类（例如“clothing”）的商品时，系统会显示错误通知并阻止结账。

/**
 * 阻止仅包含特定分类商品的结账
 *
 * @return void
 */
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 ) ) {
        return;
    }

    // 构建分类名称的链接，用于错误提示
    $category_name_html = '<a href="' . get_term_link( $category_slug, 'product_cat' ) . '">' . $product_cat->name . '</a>';

    // 检查购物车中是否只有该分类的商品
    if ( sv_wc_is_category_alone_in_cart( $category_slug ) ) {
        // 显示错误通知，解释结账被阻止的原因
        wc_add_notice( sprintf( '您好！您的购物车目前只包含 %1$s 分类的商品 &ndash; 您必须购买其他分类的商品才能结账。', $category_name_html ), '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['data']->get_id() ) ) {
            return false;
        }
    }
    // 如果遍历完所有商品，都属于指定分类，则返回 true
    return true;
}

上述代码通过 woocommerce_check_cart_items 动作钩子在结账前检查购物车内容。sv_wc_is_category_alone_in_cart 函数负责判断购物车中的所有商品是否都属于指定的分类。

引入配送方式的条件判断

现在，我们的目标是让上述分类限制仅在用户选择了非指定配送方式时生效。这意味着如果用户选择了特定的配送方式（例如“门店自提”），即使购物车中只有被限制分类的商品，也应该允许结账。

Krea AI

多功能的一站式AI图像生成和编辑平台

下载

要实现这一点，我们需要获取用户当前选择的配送方式。WooCommerce 会话（Session）中存储了用户选择的配送方式信息，可以通过 WC()->session->get('chosen_shipping_methods') 来获取。这个方法返回一个数组，其中第一个元素 [0] 通常就是当前选中的配送方式 ID。

我们将这个条件添加到 sv_wc_is_category_alone_in_cart 函数的开头。如果检测到用户选择了我们希望豁免的配送方式，函数应立即返回 false，从而跳过后续的分类检查，允许结账。

获取配送方式 ID： 您需要知道您的配送方式的唯一 ID。对于标准配送方式，例如“门店自提”，ID 通常是 local_pickup:区域ID，例如 local_pickup:8。您可以在 WooCommerce 后台的“配送区域”设置中找到具体区域的 ID，或者在前端结账页面通过浏览器开发者工具检查配送方式的 input 元素的 value 属性来获取。

完整代码示例

将配送方式的条件判断集成到原有的代码中，形成以下完整的解决方案：

/**
 * 阻止仅包含特定分类商品的结账，但允许指定配送方式豁免
 *
 * @return void
 */
function sv_wc_prevent_checkout_for_category_with_shipping_condition() {
    // 设置要限制的商品分类 slug
    $category_slug = 'clothing'; // TODO: 请替换为您的商品分类 slug

    // 获取商品分类对象
    $product_cat = get_term_by( 'slug', $category_slug, 'product_cat' );

    // 健全性检查，防止分类不存在时出现错误
    if ( is_wp_error( $product_cat ) ) {
        return;
    }

    // 构建分类名称的链接，用于错误提示
    $category_name_html = '<a href="' . get_term_link( $category_slug, 'product_cat' ) . '">' . $product_cat->name . '</a>';

    // 检查购物车中是否只有该分类的商品，并考虑配送方式条件
    if ( sv_wc_is_category_alone_in_cart_with_shipping_condition( $category_slug ) ) {
        // 显示错误通知，解释结账被阻止的原因
        wc_add_notice( sprintf( '您好！您的购物车目前只包含 %1$s 分类的商品 &ndash; 您必须购买其他分类的商品才能结账。', $category_name_html ), 'error' );
    }
}
add_action( 'woocommerce_check_cart_items', 'sv_wc_prevent_checkout_for_category_with_shipping_condition' );

/**
 * 检查购物车中是否只有指定分类的商品，并根据配送方式进行条件判断
 *
 * @param string $category_slug 商品分类 slug
 * @return bool 如果购物车中只有指定分类的商品且不符合豁免条件则返回 true，否则返回 false
 */
function sv_wc_is_category_alone_in_cart_with_shipping_condition( $category_slug ) {
    // TODO: 将 'local_pickup:8' 替换为您希望豁免的配送方式 ID
    // 例如，如果选择的是门店自提，则允许结账
    if ( isset(WC()->session->get('chosen_shipping_methods')[0]) && WC()->session->get('chosen_shipping_methods')[0] == 'local_pickup:8' ) {
        return false; // 选择了豁免的配送方式，允许结账
    }

    // 遍历购物车中的每个商品
    foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
        // 如果商品不在指定分类中，则说明购物车中不只有该分类的商品，立即返回 false
        if ( ! has_term( $category_slug, 'product_cat', $cart_item['data']->get_id() ) ) {
            return false;
        }
    }

    // 如果代码执行到这里，说明：
    // 1. 没有选择豁免的配送方式 (或者尚未选择任何配送方式)
    // 2. 购物车中的所有商品都属于指定分类
    return true;
}

注意事项与最佳实践

1. 代码放置位置： 将上述代码添加到您主题的 functions.php 文件中，或者更推荐的做法是创建一个自定义插件来管理这类功能代码，以确保在主题更新时代码不会丢失。
2. 替换占位符：
   • 将 $category_slug 变量的值替换为您实际需要限制的商品分类的 slug（例如 clothing, electronics）。
   • 将 'local_pickup:8' 替换为您希望豁免的配送方式的实际 ID。请务必确认正确的配送方式 ID。
3. 测试： 在将代码部署到生产环境之前，务必在开发或测试环境中进行充分测试，验证所有场景（仅限制分类商品、限制分类商品+豁免配送方式、混合商品等）下的结账逻辑是否符合预期。
4. 会话数据可用性： WC()->session->get('chosen_shipping_methods') 仅在用户选择配送方式后才可用。在某些情况下（例如首次加载结账页），该值可能为空或未定义。代码中已添加 isset() 检查以增强健壮性。
5. 多个配送方式： chosen_shipping_methods 是一个数组，通常 [0] 代表第一个（也是最常用的）选中项。如果您的店铺允许用户选择多个配送方式，您可能需要更复杂的逻辑来遍历这个数组。

总结

通过结合 WooCommerce 的会话数据和购物车验证钩子，我们可以实现高度定制化的条件结账逻辑。本文提供的解决方案允许您在特定商品分类和配送方式组合下精确控制用户的结账权限，从而更好地适应复杂的业务规则，提升用户体验和订单管理的灵活性。