WooCommerce购物车中基于数量动态调整商品单价的教程

本文旨在解决woocommerce购物车中商品数量变化时，单价无法灵活调整的问题。针对woocommerce默认将同款商品合并为一个购物车项的特性，我们将通过自定义代码和`woocommerce_before_calculate_totals`钩子，实现对特定商品进行动态定价，例如首个单位高价，后续单位低价的策略，从而提供更精细化的价格控制，优化用户购物体验。

在WooCommerce中，当顾客向购物车添加同一商品时，无论添加多少次，系统默认会将这些商品合并为一个购物车项，并简单地增加其数量。这意味着，如果一个商品的基础价格是200美元，当顾客将该商品数量从1增加到2，或再次点击“加入购物车”按钮时，系统通常会直接将总价更新为2 * 200美元。然而，在某些业务场景下，我们可能需要实现更复杂的定价逻辑，例如：第一个单位的价格为200美元，而所有后续单位（第二个、第三个及以后）的价格均为20美元。这种需求无法通过WooCommerce的默认设置直接实现，需要通过自定义代码进行干预。

理解WooCommerce购物车定价机制

WooCommerce的购物车系统在计算总价之前，会触发一系列钩子（Hooks），允许开发者在不同阶段修改购物车内容或价格。其中，woocommerce_before_calculate_totals 是一个非常强大的动作钩子，它在购物车总价计算之前执行，提供了访问和修改每个购物车项数据的机会。通过利用这个钩子，我们可以根据购物车项的数量、产品ID或其他自定义条件来动态调整其单价。

实现基于数量的动态单价调整

要实现“首个单位高价，后续单位低价”的逻辑，我们需要编写一个自定义函数，并将其挂载到woocommerce_before_calculate_totals钩子上。以下是实现此功能的具体步骤和示例代码。

Rose.ai

一个云数据平台，帮助用户发现、可视化数据

下载

示例代码

将以下代码添加到你的WordPress子主题的functions.php文件，或通过自定义插件添加。

<?php
/**
 * 根据购物车中商品的数量动态调整单价。
 *
 * 此函数在WooCommerce计算总价之前执行，允许开发者修改购物车项的价格。
 * 示例逻辑：对于特定产品，第一个单位价格为 $200，后续单位价格为 $20。
 *
 * @param WC_Cart $cart 购物车对象。
 */
add_action( 'woocommerce_before_calculate_totals', 'custom_dynamic_product_pricing', 99 );

function custom_dynamic_product_pricing( $cart ) {
    // 1. 安全性检查：确保只在前端执行，并避免在AJAX请求中重复执行
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return;
    }

    // 避免在某些情况下（如第三方插件）重复执行此钩子
    if ( did_action( 'woocommerce_before_calculate_totals' ) >= 2 ) {
        return;
    }

    // 2. 遍历购物车中的每一个商品项
    foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
        // 3. 定义目标产品ID和自定义价格
        // 请将 YOUR_PRODUCT_ID 替换为实际需要应用此逻辑的产品ID
        $target_product_id = 123; // 示例：目标产品ID
        $first_unit_price = 200.00; // 第一个单位的价格
        $subsequent_unit_price = 20.00; // 后续单位的价格

        // 4. 检查当前购物车项是否为目标产品
        if ( $cart_item['product_id'] == $target_product_id ) {
            $current_quantity = $cart_item['quantity']; // 获取当前购物车项的数量
            $product_data = $cart_item['data']; // 获取产品数据对象，用于设置价格

            // 5. 应用自定义定价逻辑
            if ( $current_quantity >= 1 ) {
                // 计算该购物车项的总价格：第一个单位使用 $first_unit_price，其余单位使用 $subsequent_unit_price
                $total_price_for_item = $first_unit_price; // 初始为第一个单位的价格
                if ( $current_quantity > 1 ) {
                    // 如果数量大于1，则加上 (数量 - 1) 个后续单位的价格
                    $total_price_for_item += ( $current_quantity - 1 ) * $subsequent_unit_price;
                }

                // 6. 计算该购物车项的“有效单价”
                // WooCommerce会用这个“有效单价”乘以数量来计算该购物车项的最终总价。
                // 这样做是为了确保购物车显示的总价与我们的自定义逻辑一致。
                $effective_unit_price = $total_price_for_item / $current_quantity;

                // 7. 设置购物车项的单价
                // set_price() 方法会更新产品数据对象中的价格，从而影响购物车计算。
                $product_data->set_price( $effective_unit_price );
            }
        }
        // 如果需要对所有产品应用类似逻辑，可以移除上面的 if ($cart_item['product_id'] == $target_product_id) 检查
        // 或者根据产品类别、元数据、或其他条件进行更复杂的判断。
    }
}

代码解析

1. add_action( 'woocommerce_before_calculate_totals', 'custom_dynamic_product_pricing', 99 );:
   • 将custom_dynamic_product_pricing函数挂载到woocommerce_before_calculate_totals钩子上。
   • 99是优先级，确保我们的代码在大多数其他插件修改购物车价格之后执行，以避免冲突。
2. 安全性检查:
   • is_admin() && ! defined( 'DOING_AJAX' )：确保此逻辑只在前端（非管理后台）执行，并且不是在后台的AJAX请求中。
   • did_action( 'woocommerce_before_calculate_totals' ) >= 2：这是一个防止在某些特定场景下（例如某些缓存或优化插件）钩子被重复触发的常见做法。
3. 遍历购物车项:
   • $cart->get_cart()返回当前购物车中所有商品项的数组。
   • foreach循环允许我们逐一检查和修改每个商品项。
4. 定义目标产品和价格:
   • $target_product_id：你需要将123替换为你实际想要应用此规则的产品ID。
   • $first_unit_price：第一个单位的定价。
   • $subsequent_unit_price：第二个及以后单位的定价。
5. 应用自定义定价逻辑:
   • 通过if ( $cart_item['product_id'] == $target_product_id )判断当前商品是否为目标商品。
   • 获取$current_quantity（当前购物车项的数量）和$product_data（产品数据对象）。
   • 根据数量计算$total_price_for_item：如果数量为1，则总价为$first_unit_price；如果数量大于1，则总价为$first_unit_price加上(数量 - 1)乘以$subsequent_unit_price。
6. 计算并设置有效单价:
   • 关键在于计算$effective_unit_price = $total_price_for_item / $current_quantity;。WooCommerce在显示购物车和计算总价时，会使用每个购物车项的单价乘以其数量。因此，我们需要计算出一个“有效单价”，使得当它被数量乘回时，能得到我们期望的$total_price_for_item。
   • $product_data->set_price( $effective_unit_price );：将计算出的有效单价设置到产品数据对象中，这将影响购物车和结账页面的价格显示和总价计算。

注意事项与最佳实践

• 产品ID替换：务必将示例代码中的$target_product_id = 123;替换为你实际需要应用此定价规则的产品ID。如果你需要对多个产品应用，可以将其改为一个ID数组，并使用in_array()进行检查。
• 代码位置：此代码应放置在子主题的functions.php文件中，或通过一个自定义插件添加。直接修改父主题文件会在主题更新时丢失更改。
• 优先级：add_action中的优先级99通常能确保我们的定价逻辑在大多数其他插件之后执行。如果遇到冲突，可能需要调整此优先级。
• 兼容性：在部署到生产环境之前，务必在测试环境中充分测试此代码，以确保它与你网站上的其他插件（尤其是其他定价或购物车相关插件）兼容。
• 缓存：如果你的网站使用了缓存插件，在添加或修改此代码后，可能需要清除网站缓存以确保更改生效。
• 用户体验：虽然此方法可以实现动态定价，但请确保在产品页面或其他相关位置向顾客清晰地说明定价规则，避免混淆。

通过上述方法，你可以灵活地在WooCommerce购物车中实现基于数量的动态单价调整，满足特定的业务需求，并提升网站的定制化能力。