如何为WooCommerce Analytics程序化实现基于postmeta的高级订单筛选？

你已经完成了前端筛选界面的开发，接下来需要通过后端PHP代码处理筛选逻辑，让系统根据你选择的筛选值过滤订单数据，具体步骤如下：

1. 注册并处理REST API筛选参数 #

WooCommerce Analytics通过REST API获取订单数据，首先要让API认可你的自定义筛选参数，并根据参数修改查询条件：

/**
 * 允许自定义筛选参数传递到订单报表API
 */
add_filter( 'woocommerce_rest_orders_report_query_args', 'allow_marketplace_orders_filter_param', 10, 1 );
function allow_marketplace_orders_filter_param( $args ) {
    // 从请求中获取筛选参数
    $marketplace_filter = isset( $_GET['marketplace_orders'] ) ? sanitize_text_field( $_GET['marketplace_orders'] ) : 'all';
    
    // 将参数保存到查询args中，后续用于修改查询
    if ( $marketplace_filter !== 'all' ) {
        $args['marketplace_orders'] = $marketplace_filter;
    }
    
    return $args;
}

/**
 * 根据自定义参数修改订单查询，过滤postmeta
 */
add_filter( 'woocommerce_order_report_query', 'filter_orders_by_marketplace_meta', 10, 2 );
function filter_orders_by_marketplace_meta( $query, $args ) {
    // 检查是否存在自定义筛选参数
    if ( empty( $args['marketplace_orders'] ) ) {
        return $query;
    }
    
    $meta_key = '_is_marketplace_order'; // 替换为你实际的postmeta键名
    $meta_value = 'yes'; // 替换为你要匹配的postmeta值
    
    switch ( $args['marketplace_orders'] ) {
        case 'marketplace':
            // 只保留包含指定postmeta的订单
            $query['meta_query'][] = array(
                'key'     => $meta_key,
                'value'   => $meta_value,
                'compare' => '=',
            );
            break;
        case 'not_marketplace':
            // 排除包含指定postmeta的订单，同时包含无该元数据的订单
            $query['meta_query'][] = array(
                'key'     => $meta_key,
                'value'   => $meta_value,
                'compare' => '!=',
                'type'    => 'CHAR' // 根据元值类型调整，数字类型用NUMERIC
            );
            $query['meta_query'][] = array(
                'key'     => $meta_key,
                'compare' => 'NOT EXISTS'
            );
            $query['meta_query']['relation'] = 'OR';
            break;
    }
    
    return $query;
}

2. 代码说明 #

• 替换代码中的_is_marketplace_order和yes为你实际使用的postmeta键和对应值。
• woocommerce_rest_orders_report_query_args钩子负责接收前端传递的筛选参数，并将其传入后续查询逻辑。
• woocommerce_order_report_query钩子用于修改订单查询的元数据条件，针对不同筛选值实现包含指定订单或排除指定订单的逻辑。
• 针对not_marketplace选项，同时处理了「元键不存在」的订单，确保所有非目标类型的订单都被纳入结果。

3. 测试验证 #

1. 将上述PHP代码添加到主题functions.php文件或自定义插件中。
2. 进入WooCommerce Analytics的订单报表页面，使用你创建的「Order Types」筛选器选择不同选项。
3. 检查报表数据是否符合预期：选择「Marketplace only」仅显示含指定postmeta的订单，「All but Marketplace」显示其余所有订单。

内容的提问来源于stack exchange，提问作者Faye D.