Woocommerce结账页用自定义产品字段填充下拉选择框：问题解决

编辑说明：问题已解决，已更新帖子添加解决方案。

我看到你尝试在WooCommerce结账页的下拉选择框中填充自定义产品字段_einstiegsorte的值，大部分功能正常，但在结账页获取字段值时遇到了问题。下面我帮你梳理并修正代码中的问题，让整个流程更顺畅：

1. 创建并保存自定义产品字段 #

这部分基础逻辑没问题，我优化了权限检查和空值处理，避免无效数据遗留：

// 在后台产品通用选项区域添加字段
add_action( 'woocommerce_product_options_general_product_data', 'srd_add_custom_general_fields' );
// 保存字段数据到产品元数据
add_action( 'woocommerce_process_product_meta', 'srd_add_custom_general_fields_save' );

function srd_add_custom_general_fields() {
    global $post;
    echo '<div class="options_group">';
    woocommerce_wp_textarea_input( array(
        'id'          => '_einstiegsorte',
        'label'       => __( 'Einstiegsorte', 'woocommerce' ),
        'placeholder' => '',
        'description' => __( '请输入选项，每行填写一个', 'woocommerce' ) // 添加提示更友好
    ) );
    echo '</div>';
}

function srd_add_custom_general_fields_save( $post_id ){
    // 验证用户编辑权限，避免非法操作
    if ( ! current_user_can( 'edit_product', $post_id ) ) return;
    
    $textarea_value = isset( $_POST['_einstiegsorte'] ) ? sanitize_textarea_field( $_POST['_einstiegsorte'] ) : '';
    
    if( !empty( $textarea_value ) ){
        update_post_meta( $post_id, '_einstiegsorte', $textarea_value );
    } else {
        // 若值为空，删除对应元数据避免残留
        delete_post_meta( $post_id, '_einstiegsorte' );
    }
}

2. 在产品列表页和详情页输出字段数据 #

原代码存在PHP与HTML混写的语法错误，这里修正并添加了空选项过滤：

// 产品存档页（列表页）输出字段
add_action( 'woocommerce_after_shop_loop_item_title', 'custom_fields_ausgabe_archive', 2 );
// 单品详情页输出字段
add_action( 'woocommerce_single_product_summary', 'custom_fields_ausgabe', 6);

function custom_fields_ausgabe(){
    $list_items = get_post_meta( get_the_ID(), '_einstiegsorte', true );
    if( $list_items ){
        $list_items = explode("\n", $list_items);
        echo '<ul>';
        foreach( $list_items as $list_item ) {
            // 清理空格和空行，避免无效内容显示
            $clean_item = trim( $list_item );
            if( !empty( $clean_item ) ){
                echo '<li>' . esc_html( $clean_item ) . '</li>';
            }
        }
        echo '</ul>';
    }
}

// 存档页直接复用详情页的输出函数，减少代码冗余
function custom_fields_ausgabe_archive(){
    custom_fields_ausgabe();
}

3. 结账页添加下拉选择框并填充数据 #

原代码的核心问题是：循环购物车可能生成多个下拉框、未处理空选项、表单元素属性不完整。修正后的代码如下：

add_action('woocommerce_before_checkout_form', 'einstiegswahl_select');
function einstiegswahl_select() {
    // 这里默认处理购物车中第一个商品，若需支持多商品，需修改字段命名避免冲突
    foreach ( WC()->cart->get_cart() as $cart_item ) {
        $product_id = $cart_item['product_id'];
        $list_items = get_post_meta( $product_id, '_einstiegsorte', true );
        
        if( !empty( $list_items ) ){
            $list_items = explode("\n", $list_items);
            // 过滤掉空选项和纯空格的行
            $valid_options = array_filter( array_map( 'trim', $list_items ) );
            
            if( !empty( $valid_options ) ){
                echo '<div class="einstiegswahl-container" style="margin:15px 0;">';
                echo '<label for="einstiegswahl">' . __( '请选择Einstiegsorte', 'woocommerce' ) . '</label>';
                echo '<select name="einstiegswahl" id="einstiegswahl" required>';
                // 添加默认占位选项
                echo '<option value="">' . __( '请选择一个选项', 'woocommerce' ) . '</option>';
                foreach( $valid_options as $option ) {
                    echo '<option value="' . esc_attr( $option ) . '">' . esc_html( $option ) . '</option>';
                }
                echo '</select>';
                echo '</div>';
            }
        }
        // 仅处理第一个商品，若需多商品可移除break
        break;
    }
}

额外补充：将选中的选项保存到订单 #

如果需要把用户选择的选项同步到订单中，添加以下代码：

// 保存结账页选择的选项到订单元数据
add_action( 'woocommerce_checkout_create_order', 'save_einstiegswahl_to_order', 10, 2 );
function save_einstiegswahl_to_order( $order, $data ) {
    if( isset( $_POST['einstiegswahl'] ) && !empty( $_POST['einstiegswahl'] ) ){
        $einstiegswahl = sanitize_text_field( $_POST['einstiegswahl'] );
        $order->update_meta_data( '_einstiegswahl', $einstiegswahl );
    }
}

// 在后台订单详情页显示选中的选项
add_action( 'woocommerce_admin_order_data_after_billing_address', 'display_einstiegswahl_in_order_admin', 10, 1 );
function display_einstiegswahl_in_order_admin( $order ) {
    $einstiegswahl = $order->get_meta( '_einstiegswahl' );
    if( !empty( $einstiegswahl ) ){
        echo '<p><strong>' . __( 'Einstiegsorte:', 'woocommerce' ) . '</strong> ' . esc_html( $einstiegswahl ) . '</p>';
    }
}

这些修改解决了原代码中的语法错误、空值处理问题，同时完善了结账页字段的渲染逻辑，还补充了订单保存与显示的功能，让整个自定义字段的流程闭环完整。

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