WooCommerce中通过GET参数传递主页长度字段设置购物车商品价格

我明白你的痛点：主页的自定义字段参数没法传到functions.php的价格计算函数里，试过GET参数没成功——这大概率是因为WooCommerce默认的加入购物车流程用的是POST请求，GET参数根本不会被带入到添加购物车的操作中。下面给你一套完整的可行方案，分步骤实现：

1. 改造主页的「加入购物车」区域，添加带参数的表单 #

首先，我们需要把主页上默认的加入购物车链接替换成包含长度输入框的表单，确保参数通过POST提交到WooCommerce的添加购物车流程中。把这段代码放到你的主题functions.php里：

add_filter('woocommerce_loop_add_to_cart_link', 'custom_homepage_add_to_cart_form', 10, 2);
function custom_homepage_add_to_cart_form($link, $product) {
    // 只在主页生效，其他页面保留默认按钮
    if (!is_front_page()) {
        return $link;
    }

    ob_start();
    ?>
    <form action="<?php echo esc_url($product->add_to_cart_url()); ?>" method="post" enctype="multipart/form-data">
        <?php do_action('woocommerce_before_add_to_cart_button'); ?>

        <div class="custom-length-field" style="margin: 10px 0;">
            <label for="custom_length_<?php echo $product->get_id(); ?>">长度:</label>
            <input type="number" id="custom_length_<?php echo $product->get_id(); ?>" name="custom_length" value="" min="1" step="0.1" required>
        </div>

        <button type="submit" name="add-to-cart" value="<?php echo esc_attr($product->get_id()); ?>" class="single_add_to_cart_button button alt">
            <?php echo esc_html($product->single_add_to_cart_text()); ?>
        </button>

        <?php do_action('woocommerce_after_add_to_cart_button'); ?>
    </form>
    <?php
    return ob_get_clean();
}

这段代码会在主页的每个商品下方生成一个带长度输入框的表单，用户输入的长度会通过POST请求一起提交到添加购物车的操作里。

2. 捕获并保存自定义参数到购物车项 #

接下来，我们需要用WooCommerce的钩子把POST过来的长度参数保存到购物车项的自定义数据中，这样后面计算价格时就能拿到这个值：

add_filter('woocommerce_add_cart_item_data', 'save_custom_length_to_cart_item', 10, 3);
function save_custom_length_to_cart_item($cart_item_data, $product_id, $variation_id) {
    // 检查是否有提交的长度参数
    if (isset($_POST['custom_length']) && !empty($_POST['custom_length'])) {
        // 验证并清理参数，确保是合法数字
        $length = (float)sanitize_text_field($_POST['custom_length']);
        if ($length > 0) {
            $cart_item_data['custom_length'] = $length;
            // 添加唯一键，避免同商品不同长度被合并成一个购物车项
            $cart_item_data['unique_key'] = md5(microtime() . rand());
        }
    }
    return $cart_item_data;
}

这里的unique_key很重要：如果用户买了同一个商品但不同长度，这个键会让它们在购物车里显示为独立的项，而不是被合并，方便后续分别计算价格。

3. （可选）在购物车页面显示长度参数 #

为了提升用户体验，我们可以在购物车页面显示用户输入的长度值，让用户清楚看到每个商品的参数：

add_filter('woocommerce_get_item_data', 'display_custom_length_in_cart', 10, 2);
function display_custom_length_in_cart($item_data, $cart_item) {
    if (isset($cart_item['custom_length'])) {
        $item_data[] = array(
            'key' => '长度',
            'value' => wc_format_localized_price($cart_item['custom_length']) . ' 单位'
        );
    }
    return $item_data;
}

4. 用保存的参数计算商品价格 #

现在你可以在价格计算函数中直接从购物车项数据里取出长度参数了。比如用woocommerce_before_calculate_totals钩子（如果你之前用的是其他钩子，也可以适配）：

add_action('woocommerce_before_calculate_totals', 'calculate_price_based_on_length', 10, 1);
function calculate_price_based_on_length($cart) {
    // 后台和非AJAX场景跳过，避免冲突
    if (is_admin() && !defined('DOING_AJAX')) {
        return;
    }

    // 遍历购物车中的每个商品
    foreach ($cart->get_cart() as $cart_item_key => $cart_item) {
        if (isset($cart_item['custom_length'])) {
            $product = $cart_item['data'];
            $original_price = $product->get_regular_price();
            $length = $cart_item['custom_length'];
            
            // 这里替换成你的价格计算逻辑，比如每单位长度加5元，或者按比例计算
            $new_price = $original_price * $length; // 示例：原价 × 长度
            
            // 设置新价格
            $product->set_price($new_price);
        }
    }
}

为什么之前的GET参数没成功？ #

WooCommerce默认的加入购物车操作是通过POST请求完成的，你手动加的GET参数不会被包含到添加购物车的请求里，自然无法被后端捕获。改用POST表单的方式，参数会和添加购物车的请求一起提交，就能被正确捕获了。

内容的提问来源于stack exchange，提问作者Max Vasilev