在WooCommerce后台订单页添加可编辑自定义字段并保存显示

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

    woocommerce_wp_text_input( array(
        'id'            => 'custom_km', // 字段的唯一ID，也是元数据的键名
        'label'         => __( '总公里数:', 'woocommerce' ), // 字段标签
        'value'         => $custom_km_value, // 显示已保存的值
        'wrapper_class' => 'form-field-wide', // CSS类，使字段占据整行宽度
        'description'   => __( '输入车辆总行驶公里数。', 'woocommerce' ), // 字段描述
    ) );
}

/**
 * 保存自定义字段数据到订单元数据。
 *
 * @param int $order_id 当前订单的ID。
 */
add_action( 'woocommerce_process_shop_order_meta', 'save_custom_km_field_data' );
function save_custom_km_field_data( $order_id ) {
    // 检查字段是否存在且非空
    if ( isset( $_POST['custom_km'] ) ) {
        // 清理并保存数据
        update_post_meta( $order_id, 'custom_km', wc_clean( $_POST['custom_km'] ) );
    }
}

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

    // 如果有值，则显示
    if ( ! empty( $custom_km ) ) {
        echo '<p><strong>' . __( '总公里数:', 'woocommerce' ) . '</strong><br>' . esc_html( $custom_km ) . '</p>';
    }
}

<?php
/**
 * WooCommerce 后台订单自定义字段管理
 *
 * 本文件包含在WooCommerce后台订单页面添加、保存和显示自定义字段的函数。
 */

/**
 * 1. 在WooCommerce后台订单详情后添加自定义可编辑字段。
 *
 * 使用 woocommerce_admin_order_data_after_order_details 钩子在订单详情区域后插入输入框。
 *
 * @param WC_Order $order 当前订单对象。
 */
add_action( 'woocommerce_admin_order_data_after_order_details', 'add_editable_order_custom_km_field', 12, 1 );
function add_editable_order_custom_km_field( $order ) {
    // 获取当前订单的自定义公里数，如果不存在则为空。
    // 这确保了字段在编辑时能显示已保存的值。
    $custom_km_value = get_post_meta( $order->get_id(), 'custom_km', true );

    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_process_shop_order_meta 钩子在订单保存时触发。
 *
 * @param int $order_id 当前订单的ID。
 */
add_action( 'woocommerce_process_shop_order_meta', 'save_custom_km_field_data' );
function save_custom_km_field_data( $order_id ) {
    // 检查字段是否存在且非空，并对用户输入进行清理以确保数据安全。
    if ( isset( $_POST['custom_km'] ) ) {
        update_post_meta( $order_id, 'custom_km', wc_clean( $_POST['custom_km'] ) );
    }
}

/**
 * 3. 在WooCommerce后台订单详情页显示已保存的自定义公里数。
 *
 * 使用 woocommerce_admin_order_data_after_billing_address 钩子在账单地址后显示信息。
 * 您可以根据需要选择其他钩子来调整显示位置。
 *
 * @param WC_Order $order 当前订单对象。
 */
add_action( 'woocommerce_admin_order_data_after_billing_address', 'display_custom_km_on_admin_order', 10, 1 );
function display_custom_km_on_admin_order( $order ) {
    // 获取已保存的自定义公里数。
    $custom_km = get_post_meta( $order->get_id(), 'custom_km', true );

    // 如果有值，则显示。使用 esc_html() 进行输出转义以防止XSS攻击。
    if ( ! empty( $custom_km ) ) {
        echo '<p><strong>' . __( '总公里数:', 'woocommerce' ) . '</strong><br>' . esc_html( $custom_km ) . '</p>';
    }
}