WordPress分页功能实现

1. 先唠唠WordPress分页那点事儿。你肯定遇到过文章列表太长的情况吧？一拉到底手指都酸了，这时候分页功能就是救命稻草。WordPress自己带着分页能力，但很多人压根不知道咋唤醒它。简单说，分页就是把内容切成小块喂给用户，就像吃馒头要掰开吃才舒服。

2. 核心原理其实特简单。WordPress用两个参数控制分页：paged决定当前是第几块，posts_per_page设定每块多少内容。比如你设每页5篇文章，当用户跳到第3页时，系统就自动计算"哦，要跳过前10篇，从第11篇开始拿5篇"。

$paged = ( get_query_var( 'paged' ) ) ? get_query_var( 'paged' ) : 1;
$args = array(
  'posts_per_page' => 5,
  'paged'          => $paged
);
query_posts( $args );

3. 模板里放分页导航是关键步骤。光切内容不给导航等于吃饭不给筷子。WordPress自带paginate_links()函数，但用之前得先让主循环知道要分页。有时候你会看到分页显示不正常，八成是忘了在functions.php里挂钩子。

// 在主题的index.php或archive.php里
if ( have_posts() ) : 
  while ( have_posts() ) : the_post();
    // 显示每篇文章内容
  endwhile;

  echo paginate_links( array(
    'prev_text' => __( '← 上一页' ),
    'next_text' => __( '下一页 →' ),
  ) );
endif;

4. 有个坑特别容易踩：静态首页分页失效。因为WordPress把首页当特殊页面处理，这时候需要用is_front_page()和is_paged()配合判断。我见过有人折腾半天，结果发现是没重置主查询，分页数字乱跳就像抽风似的。

// 处理静态首页分页
if ( is_front_page() && is_paged() ) {
  // 这里要特殊处理查询
}

5. 自定义查询的分页是另一个重灾区。比如你在侧边栏搞了个最新文章列表也想分页，这时候不能用主查询的paged参数，得自己创建WP_Query实例。记得用wp_reset_postdata()清理现场，不然后续循环会出鬼畜效果。

$custom_query = new WP_Query( array(
  'post_type'      => 'post',
  'posts_per_page' => 3,
  'paged'          => $paged
) );

while ( $custom_query->have_posts() ) {
  $custom_query->the_post();
  // 显示自定义查询内容
}
wp_reset_postdata();

6. 样式美化这事儿不能懒。WordPress默认分页就是光秃秃的数字链接，丑得像个2005年的网站。加点Bootstrap类或者自己写CSS，瞬间就能现代化。比如把页码做成圆角按钮，当前页用深色突出，鼠标悬停时变个色，体验立马提升三个档次。

.pagination a {
  border: 1px solid #ddd;
  padding: 5px 10px;
  border-radius: 3px;
}
.pagination .current {
  background: #0073aa;
  color: white;
}

7. 最后说说性能优化。分页深度太大时可能拖慢数据库，特别是用meta_query或tax_query的复杂查询。有个偏方是用偏移量优化，但容易引发数据重复或遗漏。稳妥的做法是给常用查询字段加数据库索引，或者用缓存插件扛住压力。

8. 其实最省事的办法是装个分页插件，但自己懂原理才能debug。就像开车不用懂造发动机，但至少得会换轮胎。下次见到分页失灵，先检查查询变量是否传递正确，再看模板函数调用是否到位，八成能自己搞定。记住，好的分页让用户感觉不到存在，就像空气一样自然。

Tags：

文章版权声明：除非注明，否则均为WP集市原创文章，转载或复制请以超链接形式并注明出处。