query_posts()

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

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索