如何在WooCommerce后台订单列表添加可排序可搜索的客户国家列

问题根源 #

你当前的实现是每次加载订单列表时，实时通过订单IP查询国家信息，该数据没有存储到数据库的订单表中，因此MySQL无法直接对其进行排序、搜索操作。要实现需求，需要先将国家数据持久化存储为订单元字段，再基于该字段实现排序、搜索逻辑。

完整可运行实现代码 #

// 新增订单列表「Customer Country」列
add_filter( 'manage_edit-shop_order_columns', function( $columns ) {
    $columns['customer_country'] = 'Customer Country';
    return $columns;
}, 10, 1 );

// 订单创建时预存客户国家到元字段，避免每次列表加载重复查询IP
add_action( 'woocommerce_checkout_update_order_meta', function( $order_id ) {
    $order = wc_get_order( $order_id );
    $user_ip = $order->get_customer_ip_address();
    $country_name = get_user_geo_country( $user_ip );
    // 同时存储国家名和国家码，方便后续排序、筛选逻辑调用
    update_post_meta( $order_id, '_customer_country_name', $country_name );
    $geo = new WC_Geolocation();
    $user_geo = $geo->geolocate_ip( $user_ip );
    update_post_meta( $order_id, '_customer_country_code', $user_geo['country'] );
}, 10, 1 );

// 渲染「Customer Country」列内容，直接读取预存元字段，大幅提升列表加载速度
add_action( 'manage_shop_order_posts_custom_column', function( $column ) {
    global $post;
    if( 'customer_country' === $column ) {
        echo get_post_meta( $post->ID, '_customer_country_name', true ) ?: '-';
    }
}, 10, 1 );

// 注册该列为可排序列
add_filter( 'manage_edit-shop_order_sortable_columns', function( $columns ) {
    $columns['customer_country'] = 'customer_country';
    return $columns;
}, 10, 1 );

// 实现列排序逻辑
add_action( 'pre_get_posts', function( $query ) {
    if( ! is_admin() || ! $query->is_main_query() ) { 
        return; 
    }
    $orderby = $query->get( 'orderby' );
    if( 'customer_country' === $orderby ) {
        $query->set( 'meta_key', '_customer_country_name' );
        $query->set( 'orderby', 'meta_value' );
    }
}, 10, 1 );

// 实现后台订单搜索支持国家关键词匹配
add_filter( 'woocommerce_shop_order_search_fields', function( $search_fields ) {
    $search_fields[] = '_customer_country_name';
    return $search_fields;
}, 10, 1 );

// 可选功能：新增国家下拉筛选框，快速筛选对应国家的订单
add_action( 'restrict_manage_posts', function( $post_type ) {
    if( 'shop_order' !== $post_type ) {
        return;
    }
    $countries = WC()->countries->get_allowed_countries();
    $selected = isset( $_GET['filter_by_country'] ) ? wc_clean( $_GET['filter_by_country'] ) : '';
    ?>
    <select name="filter_by_country">
        <option value="">所有国家</option>
        <?php foreach( $countries as $code => $name ) : ?>
            <option value="<?php echo esc_attr( $code ); ?>" <?php selected( $selected, $code ); ?>><?php echo esc_html( $name ); ?></option>
        <?php endforeach; ?>
    </select>
    <?php
}, 10, 1 );

// 处理国家筛选的查询逻辑
add_action( 'pre_get_posts', function( $query ) {
    if( ! is_admin() || ! $query->is_main_query() || ! isset( $_GET['filter_by_country'] ) || empty( $_GET['filter_by_country'] ) ) {
        return;
    }
    $country_code = wc_clean( $_GET['filter_by_country'] );
    $query->set( 'meta_key', '_customer_country_code' );
    $query->set( 'meta_value', $country_code );
}, 10, 1 );

/** 根据IP获取地理位置对应的国家名称 **/
function get_user_geo_country( $user_ip ) {
    $geo      = new WC_Geolocation();
    $user_geo = $geo->geolocate_ip( $user_ip );
    $country  = $user_geo['country'];
    return WC()->countries->countries[ $country ] ?? '-';
}

注意事项 #

• 新增代码后，历史订单不会自动生成国家元数据，你可以编写一次性脚本批量处理历史订单的IP生成对应国家数据，新生成的订单会自动存储国家信息，正常使用排序、搜索功能
• 如果你不需要国家下拉筛选功能，直接删掉对应两个钩子（restrict_manage_posts和对应的筛选逻辑pre_get_posts）即可
• 搜索功能支持直接在后台订单的全局搜索框中输入国家名称进行匹配

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