如何在 WooCommerce 分类页中限制显示的总产品数量（非每页数量）-php教程-PHP中文网

如何在 WooCommerce 分类页中限制显示的总产品数量（非每页数量）

本文介绍如何通过 woocommerce_product_query 配合 found_posts 和 post_limits 过滤器，精准控制某产品分类页全局可见的最新 10 款产品（而非仅第一页显示 10 个），彻底解决分页干扰和总数超限问题。

本文介绍如何通过 woocommerce_product_query 配合 found_posts 和 post_limits 过滤器，精准控制某产品分类页全局可见的最新 10 款产品（而非仅第一页显示 10 个），彻底解决分页干扰和总数超限问题。

在 WooCommerce 中，若需为某个特定产品分类（如 category-name）强制只显示最新的 10 款产品（总计，非每页 10 个），仅靠 posts_per_page 或 post__in 是不够的——前者影响分页逻辑但不改变总结果集，后者若未排序则无法保证“最新”；而直接使用 'limit' => 10 或裸写 post_limits 回调又常因查询上下文失效。

正确做法是双钩协同干预：一方面用 post_limits 强制 SQL 层截断结果集，另一方面用 found_posts 修正分页器显示的“总数量”，避免分页导航错误渲染（例如显示“共 2000 件，共 200 页”）。

以下是经过验证的完整解决方案（请将代码添加至主题的 functions.php 或子主题对应文件中）：

// 步骤 1：限制 SQL 查询结果为前 10 条（按发布时间倒序）
add_filter('post_limits', 'limit_category_products_to_10', 10, 2);
function limit_category_products_to_10($limits, $query) {
    // 注意：必须在 is_main_query() 下判断，避免影响后台、AJAX 或其他查询
    if (!is_admin() && $query->is_main_query() && $query->is_product_category('category-name')) {
        return 'LIMIT 0, 10';
    }
    return $limits;
}

// 步骤 2：同步修正分页统计总数为 10，防止分页器异常
add_filter('found_posts', 'override_found_posts_for_limited_category', 10, 2);
function override_found_posts_for_limited_category($found_posts, $query) {
    if (!is_admin() && $query->is_main_query() && $query->is_product_category('category-name')) {
        return 10;
    }
    return $found_posts;
}

✅ 关键说明与注意事项：

is_main_query() 是必需防护，否则会影响订单列表、产品编辑页等后台查询，导致功能异常；
'category-name' 请替换为你实际的分类 slug（非中文名称），可通过 WordPress 后台「产品 → 分类目录」URL 中的 tag_ID= 或 slug 字段确认；
该方案默认按 post_date DESC（即发布时间倒序）取最新产品。如需按其他规则（如销量、价格），应在 woocommerce_product_query 中显式设置排序：
```
$q->set('orderby', 'date'); // 默认即 date，可省略  
$q->set('order', 'DESC');
```
若你原有 woocommerce_product_query 中的 $product_ids = wc_get_product(); 逻辑存在（如动态构造 ID 列表），请务必移除或重构——它不仅低效（全量加载产品对象），还会与 post_limits 冲突，导致限制失效。