使用自定义meta_query的WooCommerce商品短代码无显示问题排查

你遇到的核心问题是短码函数的写法不符合WordPress/WooCommerce的规则，导致页面输出异常。让我拆解一下问题，再给你修正方案：

为什么原代码会导致页面内容消失？ #

WordPress的短码函数要求返回HTML字符串（或直接输出内容），但你的testt函数返回的是一个查询参数数组。当WordPress尝试处理这个短码时，无法将数组转换成有效的页面内容，甚至会打断后续的页面渲染流程，最终导致页面其余内容消失。

另外，woocommerce_shortcode_products_query过滤器是用来修改WooCommerce自带短码（比如[products]）的查询逻辑，不是用来创建自定义短码的，你的用法完全搞错了场景。

修正方案1：自定义短码渲染闪购商品 #

下面是符合规范的代码，它会正确获取闪购商品并渲染出和你商城页面一致的样式：

function flash_sale_products_shortcode() {
    // 开启输出缓冲，避免直接输出打乱页面结构
    ob_start();
    
    $today = current_time('Ymd');
    
    // 使用WooCommerce推荐的方式获取商品
    $products = wc_get_products(array(
        'post_type'      => 'product',
        'posts_per_page' => -1, // 显示所有符合条件的商品
        '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'
            ),
        )
    ));
    
    if (!empty($products)) {
        // 启动WooCommerce默认产品循环，保证样式和商城页面一致
        woocommerce_product_loop_start();
        
        foreach ($products as $product) {
            // 调用WooCommerce自带的产品模板
            wc_get_template_part('content', 'product');
        }
        
        woocommerce_product_loop_end();
    } else {
        echo '<p class="no-flash-sale">当前没有正在进行的闪购商品</p>';
    }
    
    // 返回缓冲的HTML内容
    return ob_get_clean();
}
add_shortcode('flash_sale_products', 'flash_sale_products_shortcode');

使用方式：在需要显示闪购商品的地方插入短码 [flash_sale_products] 即可。

修正方案2：复用WooCommerce自带短码（更灵活） #

如果你想利用[products]短码的现有功能（比如自定义列数、排序方式），可以通过过滤器包装一下：

function filter_products_for_flash_sale($args) {
    $today = current_time('Ymd');
    $args['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'
        ),
    );
    return $args;
}

function flash_sale_products_wrapper_shortcode($atts) {
    // 临时添加过滤器，只对当前短码生效
    add_filter('woocommerce_shortcode_products_query', 'filter_products_for_flash_sale');
    // 调用WooCommerce自带的[products]短码，支持传入列数等参数
    $output = do_shortcode('[products posts_per_page="-1" ' . $atts . ']');
    // 移除过滤器，避免影响其他短码
    remove_filter('woocommerce_shortcode_products_query', 'filter_products_for_flash_sale');
    
    return $output;
}
add_shortcode('flash_sale_products', 'flash_sale_products_wrapper_shortcode');

使用方式：除了基础用法[flash_sale_products]，还可以自定义参数，比如 [flash_sale_products columns="3" orderby="price"]。

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