queryposts是一个非常好用的调用文章函数,可以做到同页面内显示多种特定范围的文章,例如可以调用某分类、标签、日期及作者等不同范围的文章列表。这些文章列表可以极大的丰富wordpress页面的内容,并有利于SEO。二手科学家整理了下queryposts调用文章的函数,下面分别说明下。
首先是queryposts的一般写法。通常是如先定义查询再加入文章回圈程式码后再重置查询。
<?php//定义要显示的文章范围查询query_posts();//文章回圈if ( have_posts() ) : while ( have_posts() ) : the_post();?><!–这边是当判断符合时列出的文章清单,你可以用< ?php the_xxx(); >系列来显示相关的文章资讯–><?phpendwhile; else:?><!–这边是显示抓无资料时要跑出来的错误讯息–><?phpendif;//重置查询(这是为了避免之后的查询资料因为上面这段查询而混乱掉)wp_reset_query();?>
下面所有的函数都基于以上框架,只要在query_posts();里输入相应的参数来显示出自己想要的文章范围即可。
1、CategoryParameters(文章分类参数)
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、TagParameters(标签参数)
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、AuthorParameters(作者参数)
author–输入作者编号来显示该作者发表的文章
author_name–输入作者名称来显示该作者发表的文章
<?php//仅显示作者编号为3的文章query_posts(‘author=3′);//仅显示作者编号不为3的文章query_posts(‘author=-3′);//仅显示作者名称为Harriet的文章query_posts(‘author_name=Harriet’);?>
4、StickyPostParameters(置顶文章参数)
<?php//仅显示置顶文章array(‘post__in’=>get_option(‘sticky_posts’))//将文章的置顶属性清除掉,以正常文章顺序排序(例如发表日期)显示出来caller_get_posts=1?>
显示文章,但不显示置顶文章。
<?phpquery_posts(array(“post__not_in” =>get_option(“sticky_posts”)));?>
显示分类编号为6的文章、每页显示3篇文章,并且将此分类下文章的置顶属性清除掉,以正常文章顺序排序(例如发表日期)显示出来。
<?phpquery_posts(‘cat=6&posts_per_page=3&caller_get_posts=1′);?>
5、Post&PageParameters(文章&分页参数)
<?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、TimeParameters(时间参数)
显示12月20日发表的文章列表。
<?phpquery_posts(‘monthnum=12&day=20′);?>
显示本周发表文章列表。
<?php$week = date(‘W’);$year = date(‘Y’);query_posts(‘year=’ . $year .‘&w=’ .$week );?>
显示最近30天内发表的文章列表。
<?phpfunction 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);?>
7、OrderbyParameters(排列顺序参数)
<?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、PaginationParameters(分页参数)
<?php//当值设定true时则为不分页显示,直接显示全部文章nopaging=true//显示每页文章显示10篇posts_per_page=10//页数,例如当设定为6时则就表示跳到第6页paged=6//排列顺序,ASC为按时间顺序排列文章,若是DESC则是反向显示文章order=ASC?>
9、组合运用范例
显示分类编号为3且是在发表的文章。
<?phpquery_posts(‘cat=3&year=′);?>显示分类编号为1及3且每页显示两篇、依照标题逆向排列的文章。<?phpquery_posts(array(‘category__and’=>array(1,3),‘posts_per_page’=>2,‘orderby’=>title,‘order’=>DESC));?>仅在首页显示,并且是在分类编号为13的当月发表文章。<?phpif (is_home()) {query_posts($query_string . ‘&cat=13&monthnum=’ . date(‘n’,current_time(‘timestamp’)));}?>显示分类编号为1且标签为apples的文章。<?phpquery_posts(‘cat=1&tag=apples’);?>