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