WordPress 页面如何实现分页？

为什么WordPress页面需要分页？

当页面内容过长时，分页可以有效提升用户体验，降低跳出率。同时分页内容能增加页面浏览深度，对SEO也有积极影响。WordPress提供了多种分页实现方式，开发者可根据需求选择最适合的方案。

方法一：使用WordPress默认分页功能

WordPress核心已内置基本分页功能，适用于文章列表和搜索结果页：

// 在主题模板文件中添加以下代码
the_posts_pagination(array(
    'mid_size'  => 2,
    'prev_text' => __('上一页', 'textdomain'),
    'next_text' => __('下一页', 'textdomain'),
));

参数说明：
– mid_size：显示当前页前后的页码数量
– prev_text/next_text：自定义导航文本

方法二：自定义WP_Query分页

对于自定义查询结果，需要手动设置分页参数：

$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$args = array(
    'post_type' => 'post',
    'posts_per_page' => 5,
    'paged' => $paged
);
$query = new WP_Query($args);

if ($query->have_posts()) {
    while ($query->have_posts()) {
        $query->the_post();
        // 显示文章内容
    }
    
    // 分页导航
    echo paginate_links(array(
        'total' => $query->max_num_pages,
        'current' => $paged
    ));
}

方法三：使用分页插件

对于非技术用户，推荐使用以下插件：

1. WP-PageNavi：替换默认分页为更美观的数字分页
2. Advanced Post Pagination：支持文章内容分页和分页预览
3. Custom Post Limits：灵活控制每页显示数量

方法四：手动实现内容分页

对于单篇文章/页面的内容分页，可以使用<!--nextpage-->标签：

这是第一页内容
<!--nextpage-->
这是第二页内容
<!--nextpage-->
这是第三页内容

然后在模板文件中调用：

wp_link_pages(array(
    'before' => '<div class="page-links">' . esc_html__('Pages:', 'textdomain'),
    'after'  => '</div>',
));

分页优化建议

• 确保分页链接包含rel=”prev”和rel=”next”属性
• 为分页导航添加适当的ARIA标签提升可访问性
• 避免过多分页，建议每页显示5-10项内容
• 使用缓存插件优化分页页面加载速度

常见问题解答

Q：分页链接显示404错误？
A：检查固定链接设置，确保不是”朴素”模式，然后重新保存固定链接设置。

Q：如何自定义分页样式？
A：通过CSS为.pagination、.page-numbers等类添加样式，或使用Bootstrap等框架的分页组件。

Q：分页不显示页码只显示上一页/下一页？
A：增加’mid_size’参数值或检查查询结果是否只有一页内容。