WooCommerce 3+版本meta_query查询特色产品失效问题求助

嘿，这个问题我太熟了！WooCommerce 3.0版本对特色产品的存储机制做了重大调整——从原来的自定义字段（meta）改成了产品可见性分类法（product_visibility），所以你原来用meta_query查询_featured的方式肯定失效啦。下面给你一步步解决：

核心原因 #

在WooCommerce 3.0之前，特色产品是通过wp_postmeta表中的_featured字段（值为yes）来标记的；但3.0之后，官方改用了product_visibility分类法，把特色产品归到了featured这个术语下，所以必须用tax_query来替代meta_query。

具体修改步骤 #

1. 替换查询逻辑 #

把你代码中原来的meta_query部分，换成对应的tax_query：

原来失效的代码（meta_query）：

'meta_query' => array(
    array(
        'key' => '_featured',
        'value' => 'yes',
        'compare' => '='
    )
)

替换后的有效代码（tax_query）：

'tax_query' => array(
    array(
        'taxonomy' => 'product_visibility',
        'field'    => 'slug', // 用slug更稳定，避免翻译导致的name变化
        'terms'    => 'featured',
        'operator' => 'IN',
    ),
),

2. 完整的短代码函数示例 #

假设你的短代码是[wc_carousel featured="yes"]，下面是修正后的完整函数：

function woocommerce_carousel_shortcode( $atts ) {
    // 短代码参数默认值
    $atts = shortcode_atts( array(
        'featured' => 'no',
        'posts_per_page' => 6,
        'orderby' => 'date',
        'order' => 'DESC'
    ), $atts, 'wc_carousel' );

    // 基础查询参数
    $query_args = array(
        'post_type' => 'product',
        'post_status' => 'publish',
        'posts_per_page' => intval( $atts['posts_per_page'] ),
        'orderby' => $atts['orderby'],
        'order' => $atts['order']
    );

    // 如果设置了featured=yes，添加tax_query
    if ( 'yes' === strtolower( $atts['featured'] ) ) {
        $query_args['tax_query'] = array(
            array(
                'taxonomy' => 'product_visibility',
                'field'    => 'slug',
                'terms'    => 'featured',
                'operator' => 'IN',
            ),
        );
    }

    // 执行产品查询
    $products_query = new WP_Query( $query_args );

    // 输出轮播HTML
    ob_start();
    if ( $products_query->have_posts() ) {
        echo '<div class="wc-carousel-slider">';
        while ( $products_query->have_posts() ) {
            $products_query->the_post();
            // 这里可以替换成你的轮播项模板
            echo '<div class="carousel-item">';
            the_title( '<h3 class="product-title">', '</h3>' );
            the_post_thumbnail( 'woocommerce_thumbnail' );
            echo wc_get_product_price_html( wc_get_product( get_the_ID() ) );
            echo '</div>';
        }
        echo '</div>';
    } else {
        echo '<p class="no-products">没有找到符合条件的产品哦～</p>';
    }
    wp_reset_postdata();

    return ob_get_clean();
}
add_shortcode( 'wc_carousel', 'woocommerce_carousel_shortcode' );

额外检查项 #

• 确认产品确实是特色产品：进入产品编辑页，在右侧“发布”模块里勾选“特色产品”选项，更新产品。
• 避免查询冲突：检查是否有其他插件/主题过滤了产品查询，比如某些库存插件可能会修改WP_Query参数。
• 调试查询：可以在代码中添加var_dump($products_query->request);来查看生成的SQL语句，确认查询是否正确命中特色产品。

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