query_posts是wordpress非常好用的调用文章函数,可以调用某个分类、标签、日期及作者等不同范围的文章列表。下面随ytkah一起来看看query_posts函数使用方法小结
首先是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(); 里输入相应的参数来显示出自己想要的文章范围即可。
1、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))); ?>
2、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)); ?>
3、Author Parameters(作者参数)
<?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 //显示文章,但不显示置顶文章。 query_posts(array(“post__not_in” =>get_option(“sticky_posts”))); //显示分类编号为6的文章、每页显示3 篇文章,并且将此分类下文章的置顶属性清除掉,以正常文章顺序排序(例如发表日期)显示出来。 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(时间参数)
<?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); ?>
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、组合运用范例
<?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’); ?>