如何通过woocommerce_product_query限制产品分类总数量（非每页）

问题场景 #

你当前通过woocommerce_product_query钩子，将所有产品自动加入指定分类，但希望该分类仅显示最新的10个产品，而非分页显示。现有尝试的limit参数、post_limits过滤器均无效，posts_per_page仅控制每页数量，不符合需求。

核心问题修正 #

首先你现有代码中wc_get_product()的用法错误，该函数用于获取单个产品实例，无法返回所有产品ID数组。需要替换为wc_get_products()来精准获取最新10个产品的ID。

解决方案1：直接获取指定数量的最新产品ID #

替换你原有的specific_category函数，直接在获取产品时限制数量并按发布时间排序：

add_action( 'woocommerce_product_query', 'specific_category_limit_latest' );
 
function specific_category_limit_latest( $q ) {
    // 目标分类的slug或ID
    $target_category = 'category-name';
    
    // 仅在目标分类前端页面生效
    if ( $q->is_product_category( $target_category ) && ! is_admin() ) {
        // 获取最新的10个产品ID
        $latest_product_ids = wc_get_products( array(
            'status' => 'publish',
            'limit' => 10,
            'orderby' => 'date',
            'order' => 'DESC',
            'return' => 'ids' // 仅返回ID数组，提升性能
        ) );

        // 设置查询仅包含这些ID
        $q->set( 'post__in', $latest_product_ids );
        // 保持产品按获取时的顺序（最新在前）显示
        $q->set( 'orderby', 'post__in' );
        // 关闭分页总数计算，避免页面显示分页控件
        $q->set( 'no_found_rows', true );
    }
}

解决方案2：直接修改查询参数限制总数 #

如果不想单独获取产品ID，也可以直接修改查询的核心参数，强制返回10个最新产品并关闭分页：

add_action( 'woocommerce_product_query', 'limit_category_total_products' );
 
function limit_category_total_products( $q ) {
    $target_category = 'category-name';
    
    if ( $q->is_product_category( $target_category ) && ! is_admin() ) {
        // 设置仅返回10个产品
        $q->set( 'posts_per_page', 10 );
        // 按发布时间倒序（最新在前）
        $q->set( 'orderby', 'date' );
        $q->set( 'order', 'DESC' );
        // 关键：关闭查询总数量计算，彻底禁用分页逻辑
        $q->set( 'no_found_rows', true );
        // 移除分类筛选（如果需要显示全站产品中的最新10个）
        $q->set( 'product_cat', null );
    }
}

为什么之前的方法无效？ #

• limit参数：WooCommerce产品查询的limit是wc_get_products()的专属参数，并非WP_Query的可用参数，直接用$q->set('limit',10)不生效。
• post_limits过滤器：WooCommerce在处理产品查询时，会叠加自身的库存、排序等逻辑，可能会重写或忽略该全局过滤器。
• 全局is_product_category()：在woocommerce_product_query钩子中，建议使用查询对象的$q->is_product_category()判断，确保上下文匹配当前查询的场景。

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