最后更新时间为 2020年2月29日

query_posts是wordpress非常好用的调用文章函数，可以调用某个分类、标签、日期及作者等不同范围的文章列表。下面随小编一起来看看query_posts函数使用方法小结

首先是query_posts 的一般写法。通常是如先定义查询再加入文章loop后再重置查询。

<?php
//定义要显示的文章范围查询
query_posts();
//文章loop
if ( have_posts() ) : while ( have_posts() ) : the_post();
?>
<!–这边是当判断符合时列出的文章清单，你可以用< ?php the_xxx(); >系列来显示相关的文章资讯–>
<?php
endwhile; else:
?>
<!–这边是显示无资料时要跑出来的错误讯息–>
<?php
endif;
//重置查询(这是为了避免之后的查询资料因为上面这段查询而混乱掉)
wp_reset_query();
?>

下面所有的函数都基于以上框架，只要在 query_posts(); 里输入相应的参数来显示出自己想要的文章范围即可。

1、Category Parameters（文章分类参数）

<?php
//仅显示分类编号为4的文章(包括子分类文章)
query_posts(‘cat=4′);
//仅显示分类名称为Codex的文章(包括子分类文章)
query_posts(‘category_name=Codex ‘);
//显示多个分类内的文章(包括各子分类文章)
query_posts(‘cat=2,6,17,38′);
//除了分类编号为3的文章(包括子分类文章)，其他文章都显示
query_posts(‘cat=-3′);
//显示同时有分类编号为2及6的文章
query_posts(array(‘category__and’ => array(2,6)));
//显示分类编号为6的文章(但不包括子分类文章)
query_posts(array(‘category__in’ => array(6)));
//除了分类编号为2及6的文章，子分类及其他分类文章都显示
query_posts(array(‘category__not_in’ => array(2,6)));
?>

2、Tag Parameters（标签参数）

<?php
//仅显示标签带有cooking的文章
query_posts(‘tag=cooking’);
//仅显示标签带有bread或baking的文章
query_posts(‘tag=bread,baking’);
//仅显示标签带有bread及baking及recipe的文章
query_posts(‘tag=bread+baking+recipe’);
//仅显示标签带有编号37及47的文章
query_posts(array(‘tag__and’ => array(37,47));
//仅显示标签带有编号37或47的文章
query_posts(array(‘tag__in’ => array(37,47));
//仅显示标签不带有编号37或47的文章
query_posts(array(‘tag__not_in’ => array(37,47));
?>

3、Author Parameters（作者参数）

<?php
//仅显示作者编号为3的文章
query_posts(‘author=3′);
//仅显示作者编号不为3的文章
query_posts(‘author=-3′);
//仅显示作者名称为Harriet的文章
query_posts(‘author_name=Harriet’);
?>

4、Sticky Post Parameters（置顶文章参数）

<?php
//仅显示置顶文章
array(‘post__in’=>get_option(‘sticky_posts’))
//将文章的置顶属性清除掉，以正常文章顺序排序(例如发表日期)显示出来
caller_get_posts=1
//显示文章，但不显示置顶文章。
query_posts(array(“post__not_in” =>get_option(“sticky_posts”)));
//显示分类编号为6的文章、每页显示3 篇文章，并且将此分类下文章的置顶属性清除掉，以正常文章顺序排序（例如发表日期）显示出来。
query_posts(‘cat=6&posts_per_page=3&caller_get_posts=1′);
?>

5、Post & Page Parameters（文章& 分页参数）

<?php
//显示文章编号为27的文章
‘p’ => 27
//显示文章代称为about-my-life的文章
‘name’ => ‘about-my-life’
//显示分页编号为7的分页
‘page_id’ => 7
//显示分页代称为about的分页
‘pagename’ => ‘about’
//当文章超过5篇时就仅显示5篇文章并且搭配换页程式码显示换页连结，设为-1则不换页全部显示。
‘posts_per_page’ => 5
//当设定为6时就显示6篇文章，设为-1则显示范围内的全部文章。
‘showposts’ => 6
//仅显示文章编号为5,12,2,14,7的这5篇文章
‘post__in’ => array(5,12,2,14,7)
//仅显示文章编号不为5,12,2,14,7的其他全部文章
‘post__not_in’ => array(6,2,8)
//显示文章类型为分页的文章，预设值为post (文章)，可以使用的数值有attachment(媒体档页面), page(分页), post(文章),或revision(修订)。
‘post_type’ => ‘page’
//显示文章状态为公开性质的文章，可以使用的数值有pending(审核中), draft(草稿), future(排程), private(私人), trash(垃圾) 。
‘post_status’ => ‘publish’
//显示文章范围内的第93页
‘post_parent’ => 93
?>

6、Time Parameters（时间参数）

<?php
//显示12月20日发表的文章列表。
query_posts(‘monthnum=12&day=20′);
 
//显示本周发表文章列表。
$week = date(‘W’);
$year = date(‘Y’);
query_posts(‘year=’ . $year .‘&w=’ .$week );
 
//显示最近30天内发表的文章列表。
function filter_where($where = ”) {
$where .= ” AND post_date > ‘” . date(‘Ym-d’, strtotime(‘-30 days’)) . “‘”;
return $where;
}
add_filter(‘posts_where’, ‘filter_where’);
query_posts($query_string);
?>

7、Orderby Parameters（排列顺序参数）

<?php
//依照发表作者排列
orderby=author
//依照日期排列
orderby=date
//依照标题排列
orderby=title
//依照最后编辑时间排列
orderby=modified
//依照分页顺序排列(仅适用于分页)
orderby=menu_order
// (不知道XD…)
orderby=parent
//依照文章编号排列
orderby=ID
//随机排列
orderby=rand
//依照自订栏位数值排列
orderby=meta_value
//依照预设排列
orderby=none
//依照回响数排列
orderby=comment_count
?>

8、Pagination Parameters（分页参数）

<?php
//当值设定true时则为不分页显示，直接显示全部文章
nopaging=true
//显示每页文章显示10篇
posts_per_page=10
//页数，例如当设定为6时则就表示跳到第6页
paged=6
//排列顺序，ASC为按时间顺序排列文章，若是DESC则是反向显示文章
order=ASC
?>

9、组合运用范例

<?php
query_posts(‘cat=3&year=2004′);
?>
显示分类编号为1及3且每页显示两篇、依照标题逆向排列的文章。
<?php
query_posts(array(‘category__and’=>array(1,3),‘posts_per_page’=>2,‘orderby’=>title,‘order’=>DESC));
?>
仅在首页显示，并且是在分类编号为13的当月发表文章。
<?php
if (is_home()) {
query_posts($query_string . ‘&cat=13&monthnum=’ . date(‘n’,current_time(‘timestamp’)));
}
?>
显示分类编号为1且标签为apples的文章。
<?php
query_posts(‘cat=1&tag=apples’);
?>