在WooCommerce后台订单页面添加自定义可编辑字段并实现数据持久化

/**
 * 在WooCommerce后台订单详情页添加自定义可编辑字段
 *
 * @param WC_Order $order 当前订单对象
 */
add_action( 'woocommerce_admin_order_data_after_order_details', 'add_editable_custom_order_field', 12, 1 );
function add_editable_custom_order_field( $order ) {
    // 获取当前订单的自定义字段值，如果不存在则为空
    $custom_km_value = get_post_meta( $order->get_id(), 'custom_km', true );

    // 使用 woocommerce_wp_text_input 创建一个可编辑的文本输入框
    woocommerce_wp_text_input( array(
        'id'            => 'custom_km', // 字段的唯一ID，用于保存和检索数据
        'label'         => __( "总里程数:", "woocommerce" ), // 字段的显示标签
        'value'         => $custom_km_value, // 预填充字段的值，确保编辑时显示已有数据
        'wrapper_class' => 'form-field-wide', // CSS类，使字段占据完整宽度
        'description'   => __( '输入车辆服务的总里程数。', 'woocommerce' ), // 字段描述
    ) );
}

/**
 * 保存WooCommerce后台订单页面的自定义字段数据
 *
 * @param int $order_id 当前订单的ID
 */
add_action( 'woocommerce_process_shop_order_meta', 'save_custom_order_field_data' );
function save_custom_order_field_data( $order_id ) {
    // 检查是否通过POST请求提交了 'custom_km' 字段
    if ( isset( $_POST['custom_km'] ) ) {
        // 使用 wc_clean() 对数据进行清理和安全处理，防止XSS攻击
        $custom_km_value = wc_clean( $_POST['custom_km'] );
        // 使用 update_post_meta() 将数据保存到数据库
        update_post_meta( $order_id, 'custom_km', $custom_km_value );
    }
}

/**
 * 在WooCommerce后台订单详情页显示已保存的自定义里程数据
 *
 * @param WC_Order $order 当前订单对象
 */
add_action( 'woocommerce_admin_order_data_after_billing_address', 'display_custom_distance_km', 10, 1 );
function display_custom_distance_km( $order ) {
    // 获取已保存的自定义里程数据
    $custom_km = get_post_meta( $order->get_ID(), 'custom_km', true );

    // 如果数据存在，则显示
    if ( ! empty( $custom_km ) ) {
        echo '<p><strong>总里程数:</strong><br>' . esc_html( $custom_km ) . ' 公里</p>';
    }
}

<?php
/**
 * 在WooCommerce后台订单详情页添加、保存并显示自定义可编辑字段
 *
 * 请将此代码添加到您主题的 functions.php 文件或自定义插件中。
 */

/**
 * 1. 在WooCommerce后台订单详情页添加自定义可编辑字段
 * 使用 woocommerce_admin_order_data_after_order_details 钩子在特定位置插入输入框。
 */
add_action( 'woocommerce_admin_order_data_after_order_details', 'add_editable_custom_order_field', 12, 1 );
function add_editable_custom_order_field( $order ) {
    // 获取当前订单的自定义字段值，如果不存在则为空
    $custom_km_value = get_post_meta( $order->get_id(), 'custom_km', true );

    // 使用 woocommerce_wp_text_input 创建一个可编辑的文本输入框
    woocommerce_wp_text_input( array(
        'id'            => 'custom_km', // 字段的唯一ID，用于保存和检索数据
        'label'         => __( "总里程数:", "woocommerce" ), // 字段的显示标签
        'value'         => $custom_km_value, // 预填充字段的值，确保编辑时显示已有数据
        'wrapper_class' => 'form-field-wide', // CSS类，使字段占据完整宽度
        'description'   => __( '输入车辆服务的总里程数。', 'woocommerce' ), // 字段描述
    ) );
}

/**
 * 2. 保存WooCommerce后台订单页面的自定义字段数据
 * 使用 woocommerce_process_shop_order_meta 钩子在订单保存时处理数据。
 */
add_action( 'woocommerce_process_shop_order_meta', 'save_custom_order_field_data' );
function save_custom_order_field_data( $order_id ) {
    // 检查是否通过POST请求提交了 'custom_km' 字段
    if ( isset( $_POST['custom_km'] ) ) {
        // 使用 wc_clean() 对数据进行清理和安全处理，防止XSS攻击
        $custom_km_value = wc_clean( $_POST['custom_km'] );
        // 使用 update_post_meta() 将数据保存到数据库
        update_post_meta( $order_id, 'custom_km', $custom_km_value );
    }
}

/**
 * 3. 在订单详情页显示已保存的自定义里程数据
 * 使用 woocommerce_admin_order_data_after_billing_address 钩子在账单地址后显示。
 */
add_action( 'woocommerce_admin_order_data_after_billing_address', 'display_custom_distance_km', 10, 1 );
function display_custom_distance_km( $order ) {
    // 获取已保存的自定义里程数据
    $custom_km = get_post_meta( $order->get_ID(), 'custom_km', true );

    // 如果数据存在，则显示
    if ( ! empty( $custom_km ) ) {
        echo '<p><strong>总里程数:</strong><br>' . esc_html( $custom_km ) . ' 公里</p>';
    }
}