wordpress中强大的调用文章函数query posts 用法

query posts是一个非常好用的调用文章函数，可以做到同页面内显示多种特定范围的文章，例如可以调用某分类、标签、日期及作者等不同范围的文章列表。这些文章列表可以极大的丰富 Wordpress 页面的内容，并有利于SEO。二手科学家整理了下query posts调用文章的函数，下面分别说明下。

首先是query posts 的一般写法。通常是如先定义查询再加入文章回圈程式码后再重置查询。

复制代码代码如下:

<?PHP

//定义要显示的文章范围查询

query_posts();

//文章回圈

if ( have_posts() ) : while ( have_posts() ) : the_post();

?>

<!–这边是当判断符合时列出的文章清单，你可以用< ?php the_xxx(); >系列来显示相关的文章资讯–>

<?php

endwhile; else:

?>

<!–这边是显示抓无资料时要跑出来的错误讯息–>

<?php

endif;

//重置查询(这是为了避免之后的查询资料因为上面这段查询而混乱掉)

wp_reset_query();

?>

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

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

cat – 输入分类编号来显示出该分类内的文章

category_name – 输入分类名称来显示出该分类内的文章

category__and – 显示同时被列入多个分类的文章(限输入分类编号来识别)

category__in – 显示该分类内的文章，但不包括子分类内的文章(限输入分类编号来识别)

category__not_in – 除某分类内的文章，其他分类及子分类文章均显示(限输入分类编号来识别)

复制代码代码如下:

<?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（标签参数）

tag – 输入标签名称来显示含有该标签的文章

tag_id – 输入标签编号来显示含有该标签的文章

tag__and – 显示符合含有多个特定标签的的文章(限输入标签编号来识别)

tag__in – 显示符合其中一个特定标签的的文章(限输入标签编号来识别)

tag__not_in – 只要有该标签的文章一律不显示(限输入标签编号来识别)

tag_slug__and – 显示符合含有多个特定标签的的文章(限输入标签代称来识别)

tag_slug__in – 显示符合其中一个特定标签的的文章(限输入标签代称来识别)

复制代码代码如下:

<?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（作者参数）

author – 输入作者编号来显示该作者发表的文章

author_name – 输入作者名称来显示该作者发表的文章

复制代码代码如下:

<?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

?>

显示文章，但不显示置顶文章。

复制代码代码如下:

<?php

query_posts(array(“post__not_in” =>get_option(“sticky_posts”)));

?>

显示分类编号为6的文章、每页显示3 篇文章，并且将此分类下文章的置顶属性清除掉，以正常文章顺序排序（例如发表日期）显示出来。

复制代码代码如下:

<?php

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（时间参数）

显示12月20日发表的文章列表。

复制代码代码如下:

<?php

query_posts(‘monthnum=12&day=20′);

?>

显示本周发表文章列表。

复制代码代码如下:

<?php

$week = date(‘W’);

$year = date(‘Y’);

query_posts(‘year=’ . $year .‘&w=’ .$week );

?>

显示最近30天内发表的文章列表。

复制代码代码如下:

<pre name="code" class="php"><?php

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);

?></pre>

<pre></pre>

<span style="color:#507090"></span>

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、组合运用范例

显示分类编号为3且是在2004年发表的文章。

复制代码代码如下:

<?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’);

?>