Woocommerce仅显示指定日期区间商品功能失效问题求助

我尝试在WooCommerce中仅展示处于两个日期区间内的商品，当只设置单个日期区间（比如一个开始和结束日期）时功能正常，但添加第二个日期区间后，筛选功能失效，会显示所有商品。下面是我目前的代码，求解决思路：

function custom_meta_query( $meta_query ){
    $today = current_time('Ymd');
    $args = array (
        'meta_query' => array(
            'relation' => 'AND',
            array(
                'key'=>'flash_sale_start',
                'value' => $today,
                'compare'=>'<=',
                'type' => 'DATE'
            ),
            array(
                'key'=>'flash_sale_end',
                'value' => $today,
                'compare'=>'>=',
                'type' => 'DATE'
            )
        ),
    );
    $date_query = new WP_Query( $args );
    //return $meta_query;
}

// 主商店及商品归档页面的meta查询
add_filter( 'woocommerce_product_query_meta_query', 'custom_product_query_meta_query', 10, 2 );
function custom_product_query_meta_query( $meta_query, $query ) {
    if( ! is_admin() ) return custom_meta_query( $meta_query );
}

// 短代码商品查询
add_filter( 'woocommerce_shortcode_products_query', 'custom__shortcode_products_query', 10, 3 );
function custom__shortcode_products_query( $query_args, $atts, $loop_name ) {
    if( ! is_admin() ) $query_args['meta_query'] = custom_meta_query( $query_args['meta_query'] );
    return $query_args;
}

// 商品小工具查询参数
add_filter( 'woocommerce_products_widget_query_args', 'custom_products_widget_query_arg', 10, 1 );
function custom_products_widget_query_arg( $query_args ) {
    if( ! is_admin() ) $query_args['meta_query'] = custom_meta_query( $query_args['meta_query'] );
    return $query_args;
}

问题分析与修复方案 #

首先看你代码里最核心的问题：custom_meta_query函数完全没有返回有效的meta_query数组！你创建了WP_Query实例，但这毫无意义，还把原本应该返回的$meta_query给注释掉了——这直接导致所有依赖这个函数的筛选器都拿到了null，自然不会有任何筛选效果，所有商品都会显示出来。

另外，要实现两个日期区间的筛选，你需要调整meta_query的结构：外层用OR关系，每个子节点是一个独立的AND日期区间（即每个区间包含「开始日期≤今天」和「结束日期≥今天」两个条件）。

下面是修正后的完整代码：

1. 修复核心的meta_query构建函数

function custom_meta_query( $meta_query ){
    $today = current_time('Ymd');
    
    // 定义两个独立的日期区间（这里假设第二个区间用不同的meta键，你可以根据实际需求修改）
    $date_range_1 = array(
        array(
            'key'=>'flash_sale_start',
            'value' => $today,
            'compare'=>'<=',
            'type' => 'DATE'
        ),
        array(
            'key'=>'flash_sale_end',
            'value' => $today,
            'compare'=>'>=',
            'type' => 'DATE'
        )
    );
    
    $date_range_2 = array(
        array(
            'key'=>'second_promo_start', // 替换成你实际的第二个区间开始日期meta键
            'value' => $today,
            'compare'=>'<=',
            'type' => 'DATE'
        ),
        array(
            'key'=>'second_promo_end', // 替换成你实际的第二个区间结束日期meta键
            'value' => $today,
            'compare'=>'>=',
            'type' => 'DATE'
        )
    );
    
    // 组装多区间筛选逻辑：满足任意一个区间即可
    $custom_meta_query = array(
        'relation' => 'OR',
        array(
            'relation' => 'AND',
            ...$date_range_1
        ),
        array(
            'relation' => 'AND',
            ...$date_range_2
        )
    );
    
    // 合并原有的meta_query（避免覆盖其他插件/主题的筛选条件）
    if( !empty($meta_query) ){
        return array_merge( $meta_query, $custom_meta_query );
    }
    
    return $custom_meta_query;
}

2. 修正各个筛选器函数

确保每个筛选器在不需要筛选时返回原查询参数，并且正确传递meta_query：

// 主商店及商品归档页面的meta查询
add_filter( 'woocommerce_product_query_meta_query', 'custom_product_query_meta_query', 10, 2 );
function custom_product_query_meta_query( $meta_query, $query ) {
    // 仅在前端的商店/商品归档页面应用筛选
    if( ! is_admin() && ( is_shop() || is_product_taxonomy() ) ){
        return custom_meta_query( $meta_query );
    }
    return $meta_query; // 其他情况返回原查询
}

// 短代码商品查询
add_filter( 'woocommerce_shortcode_products_query', 'custom_shortcode_products_query', 10, 3 );
function custom_shortcode_products_query( $query_args, $atts, $loop_name ) {
    if( ! is_admin() ){
        // 确保meta_query存在，避免报错
        $existing_meta = isset($query_args['meta_query']) ? $query_args['meta_query'] : array();
        $query_args['meta_query'] = custom_meta_query( $existing_meta );
    }
    return $query_args;
}

// 商品小工具查询参数
add_filter( 'woocommerce_products_widget_query_args', 'custom_products_widget_query_arg', 10, 1 );
function custom_products_widget_query_arg( $query_args ) {
    if( ! is_admin() ){
        $existing_meta = isset($query_args['meta_query']) ? $query_args['meta_query'] : array();
        $query_args['meta_query'] = custom_meta_query( $existing_meta );
    }
    return $query_args;
}

关键修复点总结 #

• 修复返回值问题：custom_meta_query必须返回构建好的meta_query数组，而不是创建WP_Query实例——这是你之前功能失效的根本原因。
• 正确的多区间逻辑：用OR包裹两个AND的日期区间，确保商品满足任意一个区间就会被筛选出来。
• 合并原有查询：不要直接覆盖原有的meta_query，避免和其他功能冲突。

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