query_posts函数是制作wordpress主题中最长用且非常好用的一个调用函数,不仅可以调用文章,还可以调用某个分类、标签、日期及作者等不同范围的文章列表。
首先是query_posts 的一般写法。通常是如先定义查询再加入文章loop后再重置查询。
- <?php
- //定义要显示的文章范围查询
- query_posts();
- //文章loop
- if ( have_posts() ) : while ( have_posts() ) : the_post();
- ?>
- <!–这边是当判断符合时列出的文章清单,你可以用< ?php the_xxx(); >系列来显示相关的文章资讯–>
- <?php
- endwhile; else:
- ?>
- <!–这边是显示无资料时要跑出来的错误讯息–>
- <?php
- endif;
- //重置查询(这是为了避免之后的查询资料因为上面这段查询而混乱掉)
- wp_reset_query();
- ?>
上边是query_posts基础使用方法,更强大的功能在于可以自己自定义添加各类参数,以实现自己想要的调用内容。
Category Parameters(文章分类参数)
- <?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)));
- ?>
Tag Parameters(标签参数)
- <?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));
- ?>
Author Parameters(作者参数)
- <?php
- //仅显示作者编号为3的文章
- query_posts(‘author=3′);
- //仅显示作者编号不为3的文章
- query_posts(‘author=-3′);
- //仅显示作者名称为Harriet的文章
- query_posts(‘author_name=Harriet’);
- ?>
Sticky Post Parameters(置顶文章参数)
- <?php
- //仅显示置顶文章
- array(‘post__in’=>get_option(‘sticky_posts’))
- //将文章的置顶属性清除掉,以正常文章顺序排序(例如发表日期)显示出来
- caller_get_posts=1
- //显示文章,但不显示置顶文章。
- query_posts(array(“post__not_in” =>get_option(“sticky_posts”)));
- //显示分类编号为6的文章、每页显示3 篇文章,并且将此分类下文章的置顶属性清除掉,以正常文章顺序排序(例如发表日期)显示出来。
- query_posts(‘cat=6&posts_per_page=3&caller_get_posts=1′);
- ?>
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
- ?>
Time Parameters(时间参数)
- <?php
- //显示12月20日发表的文章列表。
- query_posts(‘monthnum=12&day=20′);
- //显示本周发表文章列表。
- $week = date(‘W’);
- $year = date(‘Y’);
- query_posts(‘year=’ . $year .‘&w=’ .$week );
- //显示最近30天内发表的文章列表。
- 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);
- ?>
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
- ?>
Pagination Parameters(分页参数)
- <?php
- //当值设定true时则为不分页显示,直接显示全部文章
- nopaging=true
- //显示每页文章显示10篇
- posts_per_page=10
- //页数,例如当设定为6时则就表示跳到第6页
- paged=6
- //排列顺序,ASC为按时间顺序排列文章,若是DESC则是反向显示文章
- order=ASC
- ?>
query_posts 组合运用范例
- <?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’);
- ?>
以上就是query_posts函数常用参数。