wordpress函数query_posts()常用用法汇总

query_posts是一个功能强大的wordpress函数,博客吧曾对query_posts()函数作过详细的介绍(请看wordpress query_posts()函数介绍),该函数的作用是在wordpress主题中控制哪些文章可以出现在主循环,比如首页、存档页的这些文章(包括分页中的)都是在主循环中的,在不使用query_posts函数控制的情况下,首页、存档页的文章都是按照文章的发布时间排列,如果自己想定义哪些文章可以显示,哪些文章不显示,文章按照什么样的方法排序等,那么就要用到query_posts函数,比如热门文章,热评文章。

下面是博客吧转载露兜博客整理的query_posts函数的几个常用用法。

基本用法:

首先介绍一下如何使用query_posts函数。在主题目录下找到存档页面文件,存档页面包括index.php、archive.php等,一般分类页、标签页、日期页和作者页等都是用archive.php,具体的WordPress主题文件构成可以看这篇文章:WordPress主题文件构成

确定了要控制哪个页面的文章列表,那么就可以开始了,比如想让首页的文章按评论数排序,那么index.php中的代码基本框架就是这样的:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<?php
 
// query_posts函数
query_posts('orderby=comment_count');
 
// 主循环
if ( have_posts() ) : while ( have_posts() ) : the_post();
 ..
endwhile; else:
 ..
endif;
 
// 重置query
wp_reset_query();
 
?>

其实要做的就是在index.php中查找if (have_posts())while (have_posts()),在前面添加query_posts函数即可。不过以上方式可能会导致首页无法分页,可以将query_posts函数改成这样的行式:

1
2
3
4
5
6
7
8
$args = array(
    // query_posts参数,具体参数可以参加官方文档
    'orderby'   => comment_count
);
 
// 下面这一行代码是必须的,不然不能分页
$arms = array_merge($args, $wp_query->query);
query_posts($arms);

下面是一些常见的query_posts函数用法:

一、不显示或只指定分类ID的文章

如果不想让某些分类的文章出现在主循环中,那么可以使用query_posts添加参数category__not_in即可:

1
2
3
4
5
6
7
$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$args = array(
    // 2, 6就是不想显示的分类ID,多个用半角逗号隔开
    'category__not_in'   => array(2, 6),
    'paged' => $paged
);
query_posts($args);

如果只想让显示某些分类的文章,可以将category__not_in改成category__in,如下:

1
2
3
4
5
6
7
$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$args = array(
    // 2, 6就是只显示的分类ID,多个用半角逗号隔开
    'category__in'   => array(3, 5),
    'paged' => $paged
);
query_posts($args);

同理,如果不显示某标签下的文章,可以将category__not_in改成:tag__not_in,或者只想让显示某个标签下的文章,可以将category__not_in改成tag__in,后面跟着标签的ID即可。

二、对文章进行排序

根据orderby的值不同,可以让文章按照很多种方式进行排序,下面代码是根据标题排列:

1
2
3
4
5
6
7
$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$args = array(
    // 以下代码中的title就是orderby的值,按标题排序
    'orderby'   => title,
    'paged' => $paged
);
query_posts($args);

列举几个常见的值及其对应的排序方式:

  • title:按标题;
  • date:按发布日期;
  • modified:按修改时间;
  • ID:按文章ID;
  • rand:随机排序;
  • comment_count:按评论数
三、调用指定ID的文章

如果只想显示ID为2,4,6的文章,可以使用以下代码:

1
2
3
4
5
6
7
$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$args = array(
    // 以下代码中的2,4,6就是文章的ID
    'post__in'   => array(2,4,6),
    'paged' => $paged
);
query_posts($args);

如果不想显示2,4,6这几篇文章,可以将 post__in 改成 post__not_in 。

四、调用置顶文章:
1
2
3
4
5
6
$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$args = array(   
    'post__in'   => get_option('sticky_posts'),
    'paged' => $paged
);
query_posts($args);
五、让置顶文章不置顶

如果你不想让置顶文章显示在顶部,而是让它们安装正常的顺序排列,那么可以使用以下代码:

1
2
3
4
5
6
$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$args=array(
    'paged' => $paged,
    'ignore_sticky_posts' => 1
);
query_posts($args);
六、列出所有状态的文章

WordPress的文章状态有很多种,包括已发布、草稿、已删除、私人的、定时发布的等等,如果你想将这些文章都统统显示出来,那么可以这样:

1
2
3
4
5
6
$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$args = array(
    'post_status' => array('publish', 'pending', 'draft', 'future', 'private', 'trash'),
    'paged' => $paged
);
query_posts($args);

post_status参数可以控制具体的文章状态,值包括pending(待审)、publish(已发布)、draft(草稿), future(定时), private(私有), trash(已删除)。

七、控制文章的数量

如果你想控制要显示的文章数量,可以使用showposts参数:

1
2
3
4
5
6
7
$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$args = array(
    // 控制只显示10篇文章,如果将10改成-1将显示所有文章
    'posts_per_page' => 10,
    'paged' => $paged
);
query_posts($args);

如果你只是想控制首页、分类页等每各分页显示的文章数量,可以在WordPress管理后台 – 设置 – 阅读那里设置博客页面至多显示多少篇文章。

代码转自露兜博客

发表留言