wordpress中query_posts()与WP_Query()分页不正确

query_posts()与WP_Query()分页不正确的问题困扰了我大半天,百度+谷歌数小时也无果,大多数解决方案都没有注意到posts_per_page值过小不能覆盖后台阅读中的设置,正当要放弃的时候找到了解决办法.

首先应该清楚,query_posts()应用于主循环,而WP_Query()用于生成次级循环.

不理解？比如,我有一个特殊的分类页面需要指定显示一定数量的文章,这个显示数量与其他分类不同,不能用后台的“设置→阅读→博客页面至多显示”来统一设置,那么就需要给这个特殊分类写一个模板,例如：category-wordpress-themes.php,此时需要用到query_posts()函数,通过参数:posts_per_page来实现控制显示的文章数量.

如果只是想在边栏等列出某分类文章列表或最新文章之类的文章列表,那么应该使用WP_Query()函数而不是query_posts(),一个页面应该最多只出现一次主循环.

按照上例所述,当我们制作了这样一个分类页后,如果需要翻页功能,就需要这样一行代码:

$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;

这是用来获取当前页码的,还需要在query_posts()中添加参数paged,代码片段如下:

1. $paged = (get_query_var('paged')) ? get_query_var('paged') : 1; 
2. $args = array( 
3. 'posts_per_page' => 20, 
4. 'paged' => $paged, 
5. 'post_status' => 'publish', 
6. 'cat' => $cat, 
7. ); 
8. query_posts($args); 
9. while (have_posts()) : the_post(); 
10. echo '<li>'; 
11. echo '<a href="' . get_permalink() . '">' . the_title_attribute('echo=0') . '</a>'; 
12. echo '</li>'; 
13. endwhile; 

看上去似乎没什么问题,可以正常翻页了,事实不然,当我们把posts_per_page的值改为5,而后台“设置→阅读→博客页面至多显示”的值默认是10,翻页就会变得不正常。

虽然这样的情况极难发生,但为了代码更完美无错,我们可以在function.php中添加如下代码解决这个问题:

1. function custom_posts_per_page($query){ 
2. if( is_category('wordpress-themes')  && $query->is_main_query() ) { 
3. $query->set('posts_per_page', 20); 
4. } 
5. } 
6. add_action('pre_get_posts', 'custom_posts_per_page'); 

这里设置的posts_per_page值需与query_posts()函数中的相同,注意判断部分,仅在我需要的分类模板中应用,且判断了是否为主循环,否则会影响次级循环的输出结果.

请注意:使用query_posts()之后必须使用wp_reset_query()重置循环,否则会影响到其他循环的输出结果,wp_reset_query()应添加在翻页代码的后面.

如果你非要使用WP_Query(),同时也需要具有翻页功能,那么就要修改你的翻页代码,通常翻页代码都封装在一个函数内,那么就要给这个函数传递参数,当前对象,例如以下代码:

1. $args = array( 
2. 'cat' => $cat, 
3. 'posts_per_page' => 10, 
4. ); 
5. $my_query = new WP_Query($args); 
6. while ($my_query->have_posts() ) : $my_query->the_post(); 
7. echo '<li><a href="' . get_permalink() . '" rel="bookmark">' . the_title_attribute('echo=0') . '</a></li>'; 
8. endwhile; 

需要将$my_query传递给翻页函数,替代默认的$wp_query,使用WP_Query()之后必须使用wp_reset_postdata();重置循环.