17370845950

本文介绍如何使用 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 '';
        echo 'term_id)) . '">';
        echo esc_html($category->name);
        echo '';
    }
} else {
    echo '
暂无分类
';
}

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

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

if ($total_pages > 1) {
    echo '';
}

? 补充说明

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

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