WooCommerce中WC_Order_Query自定义元查询zone_id参数无效问题

核心问题 #

1. 自定义参数未注册：WC_Order_Query默认只识别官方定义的查询变量，你传入的zone_id属于自定义参数，未被添加到允许的变量列表中，导致钩子woocommerce_order_data_store_cpt_get_orders_query无法获取到该参数值。
2. meta_query结构可能异常：当原查询中没有meta_query时，直接追加数组元素可能导致结构不合法，无法被WP_Query正确解析。

修正后的完整代码 #

// 注册自定义查询变量，让WC_Order_Query识别zone_id
add_filter( 'woocommerce_order_query_vars', 'add_zone_id_order_query_var' );
function add_zone_id_order_query_var( $query_vars ) {
    $query_vars[] = 'zone_id';
    return $query_vars;
}

// 修改钩子处理逻辑，确保meta_query结构正确
add_filter( 'woocommerce_order_data_store_cpt_get_orders_query', 'custom_order_query', 10, 2 );
function custom_order_query( $query, $query_vars ) {
    if ( ! empty( $query_vars['zone_id'] ) ) {
        // 初始化meta_query（如果不存在的话）
        if ( ! isset( $query['meta_query'] ) ) {
            $query['meta_query'] = array();
        }
        // 添加自定义元查询
        $query['meta_query'][] = array(
            'key'     => '_wcgd_delivery_region',
            'value'   => intval( $query_vars['zone_id'] ), // zone_id为数字类型，用intval更合适
            'compare' => '='
        );
    }
    return $query;
}

调用代码无需修改 #

你的调用代码保持原样即可：

$vars = array(
    'customer_id' => 2526,
    'limit'       => '5',
    'status'      => 'processing',
    'zone_id'     => 4,
    'return'      => 'ids'
);

$query = new WC_Order_Query( $vars );
print_r($query->get_orders());

额外说明 #

• 用intval()替代esc_attr()更合适，因为zone_id是数字类型，避免不必要的字符串转义。
• 注册自定义变量是关键步骤，否则WC_Order_Query会自动过滤掉未识别的参数，导致钩子中拿不到zone_id的值。

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