WordPress模板函数query_posts用来限定The Loop循环的查询条件,query_posts()函数可以产生一个新的查询SQL的参数,而忽略URL接收的参数。如果不希望忽略,例如搜索结果页,那么可以在调用中使用$query_string。
query_posts()函数仅用于修改主循环,而不是一种在页面上生成次级循环的手段。如果你希望在主循环外另外生成循环,应该新建独立的WP_Query对象,用这些对象生成循环。在主循环外的循环上使用query_posts()会导致主循环运行偏差,并可能在页面上显示出你不希望看到的内容。
query_posts($query)
函数参数
分类参数:
只显示特定分类下的文章。
cat :分类ID,如果是负数,则为不显示该分类文章;如果为正数,则只显示该分类文章。
category_name:分类名称
category__and:多个分类ID
category__in: 分类ID,只显示该分类文章,子分类的都不显示。
category__not_in :分类ID,不显示该分类的文章。
函数参数:
显示特定函数下的文章。
tag:函数ID,如果是负数,则为不显示该函数下文章;如果为正数,则只显示该函数下的文章。
tag_id:函数ID
tag__and:多个函数ID
tag__in:函数ID,只显示该函数下的文章。
tag__not_in:函数ID,不显示该函数下的文章。
tag_slug__and:多个函数别名
tag_slug__in:函数别名
作者参数:
你也可以根据作者来选择文章。
author:作者ID,如果是负数,则为不显示该作者下文章;如果为正数,则只显示该作者下的文章。
author_name:作者昵称
文章与页面参数:
检索单篇文章或页面。
p:根据文章ID显示文章
name:根据文章别名显示文章
page_id:页面ID
pagename:页面别名
posts_per_page:文章显示数量,-1为全部
showposts:指定多少个文章后开始翻页,不指定该参数则读取后台设置→阅读设置→博客页面至多显示
post__in:指定希望检索的文章ID
post__not_in:排除不希望检索的文章ID
post_type:页面类型,默认值为post;可用值包括any、attachment、page、post或revision。any可检索到除修订版外的所有页面类型。
post_status:可用值有publish、pending、draft、future、private、trash。最常用的是publish,用来限制私密文章。
post_parent:返回指定ID文章的子页面。
置顶文章参数:
置顶文章功能引入于WordPress 2.7版本。在查询中,被设为“置顶”的文章会显示在其它文章之前,除非该文章已经被caller_get_posts=1参数排除。
post__in:如果值为get_option(‘sticky_posts’)时,则返回所有置顶文章的数组
返回第一篇置顶文章:
$args = array(
'posts_per_page' => 1,
'post__in' => get_option('sticky_posts'),
'caller_get_posts' => 1
);
query_posts($args);
该方法返回最新发表的置顶文章,若当前无置顶文章,则返回最新发表的文章。
时间参数:
检索特定时间段内发表的文章。
hour:小时,范围从0到23
minute:分钟,范围从0到60
second:秒,范围从0到60
day:日,范围从1到31
monthnum:月,范围从1到12
year:年,如2012
w:一年中的第几周,范围从0到53
offset(偏移)参数:
排除Loop循环中出现的第一篇文章,以下代码显示最近一篇文章之后的5篇文章:
query_posts('posts_per_page=5&offset=1');
排序参数:
orderby可用的值:
author:按作者排序
date:按日期排序
title:按名称排序
modified:按修改时间排序
ID:按ID排序
rand:随机排序
comment_count:按评论数排序
order可用的值:
ASC:升序,从最低值到最高值
DESC:降序,从最高值到最低值
自定义字段参数:
根据自定义关键字或值检索文章(或页面)。
meta_key=字段名称
meta_value=字段值
meta_compare=用以测试meta_value=的操作符,默认值为“=”,其它可用的值包括“!=”、“>”、“>=”、“<”或“<=”
返回关键字为“color”且值为“blue”的文章:
query_posts('meta_key=color&meta_value=blue');
返回自定义字段关键字为“color”的文章,无论自定义字段值为何:
query_posts('meta_key=color');
返回自定义字段值为“color”的文章,无论关键字为何:
query_posts('meta_value=color');
返回自定义字段值为“green”的页面,无论自定义字段关键字为何:
query_posts('post_type=page&meta_value=green');
返回自定义关键字为“color”、自定义字段值不为“blue”的文章和页面:
query_posts('post_type=any&meta_key=color&meta_compare=!=&meta_value=blue');
返回自定义字段关键字为“miles”、自定义字段值小于等于22的文章。注意,字段值99会被看做大于字段值100,因为数据是以字符串形式而不是数字形式存储的。
query_posts('meta_key=miles&meta_compare=<=&meta_value=22');
函数使用示例
在Loop循环之前插入以下代码:
$args = array(
'category__in' => 2,
);
query_posts($args);
$args数组中可以根据自己的需要指定任意数量的参数。
如果需要分页功能,在数组之前加入代码:
$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
使用query_posts()函数,一定要在循环结束时使用wp_reset_postdata()函数来重置query。
扩展阅读
query_posts()函数位于:wp-includes/query.php