该标签可决定哪些文章出现在WordPress主循环(loop)中。该标签接收大量参数,格式与URL中的参数格式相同(如p=4表示ID为4的文章)。
为什么非要更改从URL中生成的查询语句呢?你完全可以通过结合博客文章与页面逻辑(如条件标签)来定制博客文章的样式——而无需更改任何URL。
常见用途:
重要提示query_posts函数仅用于修改主页循环(Loop),而不是一种在页面上生成次级循环的手段。如果你希望在主循环外另外生成循环,应该新建独立的WP_Query对象,用这些对象生成循环。在主循环外的循环上使用query_posts会导致主循环运行偏差,并可能在页面上显示出你不希望看到的内容。
query_posts函数会改写并取代页面的主查询。为谨慎起见,请不要将query_posts用作其它用途。
<?php//The Queryquery_posts('posts_per_page=5');//The Loopif ( have_posts() ) : while ( have_posts() ) : the_post();..endwhile; else:..endif;//Reset Querywp_reset_query();?>
用法提示
在主循环开始前,对你的某个模板文件的query_posts()安排一个调用。wp_query对象会利用参数生成新的SQL查询。当你开始调用时,WordPress会忽略通过URL接收到的其它参数(如页面编号或分类)。如果你希望保留这些信息,可以在对query_posts()的调用中使用$query_string全局变量。
例如,要设置文章的显示顺序而不影响查询字符串的剩余部分,可以将以下代码添加到主循环(loop)之前:
global $query_string; query_posts($query_string . "&order=ASC");
以这种方式使用query_posts时,参数所引用的部分必须以&符号开头。
将以下代码添加到index.php文件中,使主页显示的文章可以来自除分类3以外的任何分类。
<?phpif (is_home()) {query_posts("cat=-3");}?>
你也可以多排除几个分类。
<?phpif (is_home()) {query_posts("cat=-1,-2,-3");}?>
用以下语句检索某篇指定文章:
<?php// retrieve one post with an ID of 5query_posts('p=5'); ?>
如果你希望在查询语句中使用Read More功能,请将全局变量$more设为0。
<?php// retrieve one post with an ID of 5query_posts('p=5');global $more;// set $more to 0 in order to only get the first part of the post$more = 0;// the Loopwhile (have_posts()) : the_post(); // the content of the postthe_content('Read the full post ?'); endwhile;?>
用以下语句检索某篇指定页面:
<?phpquery_posts('page_id=7'); //retrieves page 7 only?>
或者
<?phpquery_posts('pagename=about'); //retrieves the about page only?>
检索子页面时,需要提供子页面及其父页面的别名,用斜线隔开两者。例如:
<?phpquery_posts('pagename=parent/child'); // retrieve the child page of a parent?>
有两种方法可以给给查询传递变量,你可以根据自己的需求从中选择一种。使用时,将代码添加到循环中:
示例1
在这个例子中,我们在运行查询语句前先连结所有查询。首先赋值变量,然后连结变量并运行。这里我们要从别处引入一个分类变量。
<?php$categoryvariable=$cat; // assign the variable as current category$query= 'cat=' . $categoryvariable. '&orderby=date&order=ASC'; // concatenate the queryquery_posts($query); // run the query?>
示例2
这个示例将使用双引号来告诉PHP将引号中的内容当成表达式。在下面的例子中,我们要获取当前月份、年份时间,然后让query_posts获取当前月/年的文章,并且以升序方式在页面最上方显示发表日期最早的文章。
<?php$current_month = date('m');$current_year = date('Y');query_posts("cat=22&year=$current_year&monthnum=$current_month&order=ASC");?>
示例3
该示例说明了怎样生成一个完整的文章分页列表。我们可以用默认的$query_string来命令query_posts给我们显示一个完整的文章列表。也可以将posts_per_page查询语句从-1改成你希望在每页显示的文章数。在后面这种情况下,你可以用posts_nav_link 来导航所生成的存档。
<?php query_posts($query_string.'&posts_per_page=-1');while(have_posts()) { the_post();}?>
示例4
如果你不需要使用$query_string变量,可以在一些复杂的情况下使用一个更简单易读的方法。这个方法就是,将参数放入数组。那么通过下面的代码,也可以生成示例2中的查询:
query_posts(array('cat' => 22, 'year' => $current_year, 'monthnum' => $current_month, 'order' => 'ASC',));
现在你可以看到,所有变量都独立成行,更加便于阅读。
保留原始查询
如果你希望保留原始查询,可以将原始查询数组整合到参数数组中:
global $wp_query;query_posts(array_merge(array('cat' => 1),$wp_query->query));
这里并没有列出完整的参数列表。我们在这里介绍这些参数,只是为了让你多了解一些关于如何设置查询的信息。
只显示特定分类下的文章。
根据ID显示单个分类
只显示来自某一个分类目录ID(以及该分类目录下的子分类目录)的文章:
query_posts('cat=4');
根据分类名称显示单个分类
只显示来自某一个分类名称下的文章:
query_posts('category_name=Staff Home');
根据ID显示多个分类
显示来自若干指定分类目录ID下的文章:
query_posts('cat=2,6,17,38');
排除某一分类中的文章
显示除某一分类文章外的所有文章,被排除的分类ID以减号('-')作为前缀。
query_posts('cat=-3');
以上代码删除ID为3的分类中的文章。
处理多个分类
显示隶属于多个分类的文章。下面的代码可展示同时属于分类2和分类6的文章:
query_posts(array('category__and' => array(2,6)));
如果希望显示分类2或分类6中的文章,可以使用上面介绍的cat,也可以使用category_in函数 (注意这里不会显示分类下子分类中的文章) :
query_posts(array('category__in' => array(2,6)));
可以用下面这种方式排除多个分类中的文章:
query_posts(array('category__not_in' => array(2,6)));
显示特定标签下的文章。
获取某一标签中的文章
query_posts('tag=cooking');
获取若干标签中任一标签中的文章
query_posts('tag=bread+baking+recipe');
多个标签
显示同时属于ID为37和47的标签下的文章:
query_posts(array('tag__and' => array(37,47));
若要显示ID为为37或47的标签下的文章,可以使用tag参数,也可以用tag_in:
query_posts(array('tag__in' => array(37,47));
显示的文章既不属于标签37,也不属于标签47:
query_posts(array('tag__not_in' => array(37,47));
tag_slug_in与tag_slug_and工作方式几乎一致,不同之处在于相匹配的别名不同。
你也可以根据作者来选择文章。
注意:author_name运行在user_nicename字段上,同时author运行在author id字段上。
显示ID为1的作者所发表的所有页面,以标题顺序排列页面,页面列表上方无置顶文章:
query_posts('caller_get_posts=1&author=1&post_type=page&post_status=publish&orderby=title&order=ASC');
检索单篇文章或页面。
置顶文章功能引入于WordPress 2.7。在查询中,被设为“置顶”的文章会显示在其它文章之前,除非该文章已经被caller_get_posts=1参数排除。
array('post__in'=>get_option('sticky_posts')) —— 返回所有置顶文章的数组 caller_get_posts=1 —— 排除返回的文章上方的置顶文章,但在返回文章列表时,以自然顺序将曾经置顶的文章安插在列表中。 返回第一篇置顶文章
$sticky=get_option('sticky_posts') ; query_posts('p=' . $sticky[0]);
或
$args = array('posts_per_page' => 1,'post__in' => get_option('sticky_posts'),'caller_get_posts' => 1);query_posts($args);
注意:第二种方法只能返回最新发表的置顶文章;若当前无置顶文章,返回最新发表文章。
返回第一篇置顶文章;若无,则不返回任何内容
$sticky = get_option('sticky_posts');$args = array('posts_per_page' => 1,'post__in' => $sticky,'caller_get_posts' => 1);query_posts($args);if($sticky[0]) {// insert here your stuff...}
从查询中排除所有置顶文章
query_posts(array("post__not_in" =>get_option("sticky_posts")));
返回某一分类下所有文章,但不在文章列表上方显示置顶文章。所有设为“置顶”的文章以正常顺序(如日期顺序)显示
query_posts('caller_get_posts=1&posts_per_page=3&cat=6');
返回某一分类下所有文章,完全不显示置顶文章,保留分页
<?php$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;$sticky=get_option('sticky_posts');$args=array('cat'=>3,'caller_get_posts'=>1,'post__not_in' => $sticky,'paged'=>$paged,);query_posts($args);?>
检索特定时间段内发表的文章。
返回最近发表的文章
$today = getdate(); query_posts('year=' .$today["year"] .'&monthnum=' .$today["mon"] .'&day=' .$today["mday"] );
返回12月20日发表的文章
query_posts(monthnum=12&day=20' );
返回2009年3月1日到3月15日之间发表的文章
<?php//based on Austin Matzko's code from wp-hackers email listfunction filter_where($where = ) {//posts for March 1 to March 15, 2009$where .= " AND post_date >= '2009-03-01' AND post_date < '2009-03-16'";return $where;}add_filter('posts_where', 'filter_where');query_posts($query_string);?>
返回最近30天内发表的文章
<?php//based on Austin Matzko's code from wp-hackers email listfunction filter_where($where = ) {//posts in the last 30 days$where .= " AND post_date > '" . date('Y-m-d', strtotime('-30 days')) . "'";return $where;}add_filter('posts_where', 'filter_where');query_posts($query_string);?>
返回过去30天到过去60天内发表的文章
<?php//based on Austin Matzko's code from wp-hackers email listfunction filter_where($where = ) {//posts 30 to 60 days old$where .= " AND post_date >= '" . date('Y-m-d', strtotime('-60 days')) . "'" . " AND post_date <= '" . date('Y-m-d', strtotime('-30 days')) . "'";return $where;}add_filter('posts_where', 'filter_where');query_posts($query_string);?>
通过offset参数,你可以移除或忽略正常情况下被查询集中的一篇或多篇初始文章。
以下显示最近一篇文章之后的5篇文章:
query_posts('posts_per_page=5&offset=1');
决定以升序或降序排列排序参数
根据自定义关键字或值检索文章(或页面)。
返回关键字为 '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');
你可能已经从上面有些例子中看出来了,可以用&符号连接不同参数,如:
uery_posts('cat=3&year=2004');
显示主页上、当前月份发表的、隶属于分类13下的文章:
if (is_home()) {query_posts($query_string . '&cat=13&monthnum=' . date('n',current_time('timestamp')));}
在WP 2.3中,以下参数联合会返回同时属于分类1和分类3的两篇文章,以文章标题降序排列:
query_posts(array('category__and'=>array(1,3),'posts_per_page'=>2,'orderby'=>title,'order'=>DESC));
在WP 2.3和WP 2.5中,以下参数联合本应返回属于分类1且带有“apples”标签的文章:
query_posts('cat=1&tag=apples');
但由于一个bug,代码没能显示出正常结果。详情请见Ticket #5433。有一个解决办法:利用+号查找多个标签:
query_posts('cat=1&tag=apples+apples');
这就显示出我们希望显示的结果了。
设置>阅读中的“博客页面最多显示”参数会影响你的查询结果,要覆盖设置>阅读中的设置,需要在标签中添加'posts_per_page' 参数。例如:query_posts('category_name=The Category Name&posts_per_page=-1'); //returns ALL from the category
联系客服