本文介绍如何使用 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 分类 + 手动分页”的效果，兼顾可维护性与用户体验。
