WordPress分类分页显示设置方法

积累知识，胜过积蓄金银！毕竟在文章开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《WordPress 限制分类数量并分页显示方法》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

本文介绍如何使用 PHP 的 `array_chunk()` 函数对 WordPress 分类列表进行分组，实现每页仅显示 3 个分类，并支持手动分页控制。

在 WordPress 主题开发中，有时需要避免一次性展示全部分类（尤其是分类数量较多时），转而采用“每页固定数量 + 分页”方式提升页面可读性与用户体验。你当前使用的 get_categories() 默认返回所有分类，配合 foreach 循环会全部输出。要实现“每页仅显示 3 个分类”，核心思路是：先获取完整分类数组，再按需切片分页，而非依赖数据库层面的分页参数（因 get_categories() 不原生支持 offset/number 组合分页）。

以下是推荐的实现方案：

✅ 步骤一：获取并分块分类数据

// 获取所有分类（可选：传入 'hide_empty' => false 等参数定制）
$categories = get_categories([
    'hide_empty' => false, // 根据需求调整
]);

// 每 3 个分类为一组，生成二维数组
$data = array_chunk($categories, 3);

// 计算总页数（用于构建分页导航）
$total_pages = count($data);

// 获取当前页码（注意：需做安全校验）
$page = isset($_GET['page_number']) ? (int) $_GET['page_number'] : 1;
$page = max(1, min($page, $total_pages)); // 限制页码范围 [1, $total_pages]

✅ 步骤二：输出当前页的分类项

// 输出第 $page 页的分类（索引从 0 开始，故减 1）
if (!empty($data[$page - 1])) {
    foreach ($data[$page - 1] as $category) {
        echo '<div class="col-md-4">';
        echo '<a href="' . esc_url(get_category_link($category->term_id)) . '">';
        echo esc_html($category->name);
        echo '</a></div>';
    }
} else {
    echo '<p class="text-muted">暂无分类</p>';
}

⚠️ 重要安全提示：

• 务必使用 esc_url() 转义链接 URL，防止 XSS；
• 使用 esc_html() 输出分类名称，避免 HTML 注入；
• 对 $_GET['page_number'] 进行强制类型转换和边界校验，防止越界访问或非法输入。

✅ 步骤三：添加基础分页导航（示例）

if ($total_pages > 1) {
    echo '<nav class="pagination mt-4"><ul class="pagination justify-content-center">';
    for ($i = 1; $i <= $total_pages; $i++) {
        $active = ($i === $page) ? 'active' : '';
        echo '<li class="page-item ' . $active . '">';
        echo '<a class="page-link" href="?page_number=' . $i . '">' . $i . '</a>';
        echo '</li>';
    }
    echo '</ul></nav>';
}

? 补充说明

• array_chunk() 是 PHP 内置函数，简洁高效，适用于中小规模分类（如 ≤500 个）。若分类量极大（如数千），建议改用 WP_Query 或自定义 SQL 查询 + LIMIT/OFFSET 实现服务端分页，以降低内存开销。
• WordPress 官方函数 get_categories() 不支持 offset 参数（即使传入也无效），因此无法直接通过 number 和 offset 实现真分页——这是本方案采用客户端分块的根本原因。
• 如需 SEO 友好或支持浏览器前进/后退，可结合 add_rewrite_rule 实现伪静态分页 URL（如 /categories/page/2/），但需刷新重写规则。

通过以上方法，你即可在模板中稳定、安全地实现“每页 3 分类 + 手动分页”的效果，兼顾可维护性与用户体验。

终于介绍完啦！小伙伴们，这篇关于《WordPress分类分页显示设置方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！