如何用变量预填充woocommerce_form_field的实际值？

我明白你想给客户推荐一个预填充值，让他们可以直接保留或者修改，而且这个值要能随订单提交——占位符确实只是提示，不会被提交，所以得从字段的实际默认值入手。下面分几种场景给你具体方案：

一、添加自定义结账字段并预填充值 #

如果你是要加一个全新的结账字段，直接在woocommerce_form_field的参数里设置value就行，这个就是会被提交的默认值：

// 添加自定义结账字段
add_action( 'woocommerce_after_order_notes', 'add_prefilled_custom_checkout_field' );
function add_prefilled_custom_checkout_field( $checkout ) {
    // 这里替换成你的预填充变量：比如从用户信息、会话或者其他逻辑获取
    $recommended_value = get_user_meta( get_current_user_id(), 'user_preferred_option', true );
    // 如果没有获取到值，设置一个默认推荐内容
    if ( empty( $recommended_value ) ) {
        $recommended_value = "我们为您推荐的默认选项";
    }

    woocommerce_form_field( 'customer_preferred_option', array(
        'type'          => 'text',
        'class'         => array('form-row-wide'),
        'label'         => __('您的选择'),
        'placeholder'   => __('可修改为您需要的内容'), // 占位符仅做提示
        'value'         => $recommended_value, // 这个是实际预填充的、会被提交的值
    ), $checkout->get_value( 'customer_preferred_option' ) );
}

// 把字段值保存到订单
add_action( 'woocommerce_checkout_update_order_meta', 'save_prefilled_custom_field_to_order' );
function save_prefilled_custom_field_to_order( $order_id ) {
    if ( ! empty( $_POST['customer_preferred_option'] ) ) {
        update_post_meta( $order_id, 'customer_preferred_option', sanitize_text_field( $_POST['customer_preferred_option'] ) );
    }
}

二、修改已有WooCommerce字段的预填充值 #

如果是要修改默认的结账字段（比如账单电话、地址等），可以用woocommerce_checkout_fields钩子来设置字段的default属性：

add_filter( 'woocommerce_checkout_fields', 'prefill_existing_checkout_field' );
function prefill_existing_checkout_field( $fields ) {
    // 这里替换成你的预填充变量，比如从用户会话或者其他业务逻辑获取
    $recommended_phone = "13800138000";

    // 修改账单电话的默认值
    $fields['billing']['billing_phone']['default'] = $recommended_phone;

    // 如果要修改其他字段，比如账单地址，同理：
    // $fields['billing']['billing_address_1']['default'] = "XX街道XX号";

    return $fields;
}

三、产品页面自定义字段的预填充 #

如果是在产品页面添加需要预填充的字段（比如定制选项），并随产品加入购物车、提交订单，代码如下：

// 在产品页面添加预填充字段
add_action( 'woocommerce_before_add_to_cart_button', 'add_prefilled_product_custom_field' );
function add_prefilled_product_custom_field() {
    $recommended_custom = "我们推荐的定制内容"; // 你的预填充变量
    ?>
    <div class="product-custom-field">
        <label for="custom_product_option"><?php _e('定制需求'); ?></label>
        <input type="text" id="custom_product_option" name="custom_product_option" value="<?php echo esc_attr($recommended_custom); ?>">
    </div>
    <?php
}

// 把字段值保存到购物车项
add_action( 'woocommerce_add_cart_item_data', 'save_product_custom_field_to_cart', 10, 2 );
function save_product_custom_field_to_cart( $cart_item_data, $product_id ) {
    if ( isset( $_POST['custom_product_option'] ) ) {
        $cart_item_data['custom_product_option'] = sanitize_text_field( $_POST['custom_product_option'] );
        $cart_item_data['unique_key'] = md5( microtime().rand() ); // 确保每个购物车项的字段唯一
    }
    return $cart_item_data;
}

// 在购物车和结账页面显示字段值
add_filter( 'woocommerce_get_item_data', 'display_product_custom_field_in_cart', 10, 2 );
function display_product_custom_field_in_cart( $item_data, $cart_item ) {
    if ( isset( $cart_item['custom_product_option'] ) ) {
        $item_data[] = array(
            'key' => __('定制需求'),
            'value' => $cart_item['custom_product_option']
        );
    }
    return $item_data;
}

// 把字段值保存到订单订单项
add_action( 'woocommerce_checkout_create_order_line_item', 'save_product_custom_field_to_order', 10, 4 );
function save_product_custom_field_to_order( $item, $cart_item_key, $values, $order ) {
    if ( isset( $values['custom_product_option'] ) ) {
        $item->add_meta_data( __('定制需求'), $values['custom_product_option'] );
    }
}

关键注意点 #

• 不要混淆placeholder和value：placeholder只是输入框里的灰色提示，不会被提交；value（自定义字段）或default（已有字段）才是真正的预填充值，会随表单提交。
• 安全处理用户输入：一定要用sanitize_text_field之类的函数过滤用户输入，避免安全问题。
• 个性化预填充：如果是针对登录用户，可以用get_user_meta获取用户之前保存的信息，实现更精准的推荐。

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