query_posts()的参数使用方法

query_posts()的参数使用方法，纪录在这，以免忘记

将query_posts()放在LOOP之前限定你所需要的条件，wp_query会产生一个新的使用你的参数的SQL查询，而忽视通过URL接收到的其它的参数，如果想不忽略，可以在调用中使用$query_string。

query_posts($query_string . "&order=ASC")

设置文章显示的顺序，但是不干扰其余的查询字符串，参数前须有"&"符号

其他还有N多用途~~

· 主页不显示某一分类下的日志

· 获得特定的日志

· 获得特定的页面



· 创建所有文章列表，并且提供分页功能

==========================================

类别 参数

显示属于某个类别的文章

· cat

· category_name

根据ID显示一个类别

只显示来自一个类别ID的文章

query_posts('cat=4');

根据名称显示一个类别

只显示属于某个类别名的文章

query_posts('category_name=Staff Home');

显示几个类别及ID

显示属于几个类别ID的文章

query_posts('cat=2,6,17,38');

删除某个类别的文章

显示所有的文章，但是类别ID前面有个'-'（负号）负号的类被除外。

query_posts('cat=-3');

删除属于类别3的所有文章。有一个限制性条款：会删除只属于类别3的所有文章。如果一个类别也同时属于其它的类别，这个类别仍然不会被删除。

标签参数

显示与某个标签相关的文章

· tag

为某个标签提取文章

query_posts('tag=cooking');

获得拥有任何这样的标签的文章

query_posts('tag=bread,baking');

获取拥有这三个标签的文章

query_posts('tag=bread+baking+recipe');

作者参数

你也可以根据作者限制文章数目

· author_name=Harriet

· author=3

author_name在 user_nicename区操作, 同时作者 在作者id上操作。

文章 & 网页参数

返回一篇单独的文章或者一个单独的网页

· p=1 – 使用文章 ID来显示第一篇文章

· name=first-post – 使用 post Slug 显示第一篇文章

· page_id=7

· pagename=about

· showposts=1 (你可以使用 showposts=3,或者其它的任何数字显示一定数目的文章)

由于 模板层级方面的原因, home.php先执行了。这意味这你可以编写一个home.php，home.phh调用query_posts()重新得到一个特别的网页并且将那个网页设置为你的首页。没有任何插件或者hacks，你需要运行一个机制，并且显示和维护一个非博客的首页。

更有用的方法，可能是利用WP的网页功能并且为你的首页使用这个功能。你可以将"关于网页"设置为entry point或者设置为站点的末页。你可能执行一些更动态的步骤，设置一个自定义网页，显示最近的评论，文章，类别，存档。请看看下面的例子。

时间参数

得到某个特别的时间段内发表的文章

· hour=

· minute=

· second=

· day= – 一个月中的每一天; 显示，例如，十五号发表的所有文章。

· monthnum=

· year=

网页参数

· paged=2 -显示使用"以前发表的文章"链接时，通常在网页2上显示的文章。

· posts_per_page=10 -每个网页显示的文章数目；-1这个值，会显示所有的文章。

· order=ASC -按时间顺序显示文章，以相反的顺序显示DESC（默认）

Offset 参数

你不能转移或者忽视一个或者更多的原始文章，这些文章一般是你的query同时使用offset参数收集到的。

下面的函数会显示（1）最近的5篇文章

query_posts('showposts=5&offset=1');

根据参数排序

根据这个区给得到的文章排序

· orderby=author

· orderby=date

· orderby=category

· orderby=title

· orderby=modified

· orderby=modified

· orderby=menu_order

· orderby=parent

· orderby=ID

· orderby=rand

同时考虑"ASC"或者的"DESC"的排序参数

联合参数

你可能从上面的例子中注意到，你使用一个&（&符号）将参数组合在一起，像：

query_posts('cat=3&year=2004');

类别13，关于当前月份显示在主页上的文章：

if (is_home()) { 
query_posts ($query_string . '&cat=13&monthnum=' . date('n',current_time('timestamp'))); }

在2.3版本中，这个参数组合会返回属于类别1同时属于类别3的文章，只显示两篇（2）文章，根据标题，按降序排列：

query_posts(array('category__and'=>array(1,3),'showposts'=>2,'orderby'=>title,'order'=>DESC));

在2.3和2.5版本中，你可能期待下面的内容，返回属于类别1并且标签为"苹果"的所有文章

query_posts('cat=1&tag=apples');

一个bug阻止这个运行。请看看Ticket #5433，一个工作区要搜索几个使用+的标签

query_posts('cat=1&tag=apples+apples');

对于先前的查询，这个会产生期待的结果。注意使用'cat=1&tag=apples+oranges'能够产生期待的结果。

query_posts函数在WordPress主题中是用于控制哪些文章可以出现在主循环中，可能说主循环很多人都不懂，那么举个例子，首页、存档页的这些文章（包括分页中的）都是在主循环中的。在不使用query_posts函数控制的情况，首页、存档页等都是按照文章的发布时间列出你博客上所有已发布的文章，而如果你想定义哪些文章可以显示，哪些文章不显示，文章按照什么样的方法排序等，那么你就要用到query_posts函数了，本站首页的文章排序：随机阅读、评论最多和标题排序就是用query_posts函数来实现的。

基本用法：

首先介绍一下如何使用query_posts函数。在主题目录下找到存档页面文件，存档页面包括index.php、archive.php等，一般分类页、标签页、日期页和作者页等都是用archive.php

确定了你要控制哪个页面的文章列表，那么我们就可以开始了，比如你想让首页的文章按评论数排序，那么index.php中的代码基本框架就是这样的：

其实你要做的就是在index.php中查找if (have_posts())或while (have_posts())，在前面添加query_posts函数即可。不过以上方式可能会导致首页无法分页，那你可以将query_posts函数改成这样的行式：

// 下面这一行代码是必须的，不然你的首页不能分页

$paged = (get_query_var('paged')) ? get_query_var('paged') : 1; 


$args = array( 

// 这里以下面的方式添加query_posts参数，具体参数可以参加官方文档

'orderby' => comment_count, 

'paged' => $paged 

); 

query_posts($args);

下面是一些常见的query_posts函数用法，你可以直接用到你的主题中。

一、只显示含有某个自定义字段的文章

如果你想只显示添加了某个自定义字段的文章，并按照这个字段的值来对文章排序

其实这种方式你可以看成怎样只显示我推荐的文章，那么含有这个自定义字段的文章就是推荐文章。

二、怎样让某分类的文章不显示/显示

如果你不想让某分类的文章出现在主循环中，那么你可以使用query_posts添加参数category__not_in即可：

$paged = (get_query_var('paged')) ? get_query_var('paged') : 1; 

$args = array( 

// 2, 6就是你不想显示的分类ID，多个用半角逗号隔开

'category__not_in' => array(2, 6), 

'paged' => $paged 

); 

query_posts($args);

如果只想让显示某个分类的文章，可以将category__not_in改成category__in。同理，如果不显示某标签下的文章，可以将category__not_in改成：tag__not_in，或者只想让显示某个标签下的文章，可以将category__not_in改成 tag__in，后面跟着标签的ID即可。

三、如何对文章进行排序

$paged = (get_query_var('paged')) ? get_query_var('paged') : 1; 

$args = array( 

// 以下代码中的title就是orderby的值，按标题排序

'orderby' => title, 

'paged' => $paged 

); 

query_posts($args);

根据orderby的值不同，可以让文章按照很多种方式进行排序，下面是列举几个常见的值及其对应的排序方式:title：按标题；date：按发布日期；modified：按修改时间；ID：按文章ID；rand：随机排序；comment_count：按评论数

四、只显示相应ID的文章

如我只想显示ID为2,4,6的文章，可以使用以下代码：

$paged = (get_query_var('paged')) ? get_query_var('paged') : 1; 

$args = array( 

// 以下代码中的2,4,6就是文章的ID 

'post__in' => array(2,4,6), 

'paged' => $paged 

); 

query_posts($args);

如果不想显示2,4,6这几篇文章，可以将 post__in 改成 post__not_in 。另外如果只想显示置顶文章，那么可以将array(2,4,6)改成get_option('sticky_posts')，这段代码会自动给你填充所有置顶文章的ID。

五、让置顶文章不置顶

如果你不想让置顶文章显示在顶部，而是让它们安装正常的顺序排列，那么可以使用以下代码：

$paged = (get_query_var('paged')) ? get_query_var('paged') : 1; 

$args=array( 

'paged' => $paged, 

'caller_get_posts' => 1 

); 

query_posts($args);

六、列出所有状态的文章

WordPress的文章状态有很多种，包括已发布、草稿、已删除、私人的、定时发布的等等，如果你想将这些文章都统统显示出来，那么可以这样：

$paged = (get_query_var('paged')) ? get_query_var('paged') : 1; 

$args = array( 

'post_status' => array('publish', 'pending', 'draft', 'future', 'private', 'trash'), 

'paged' => $paged 

); 

query_posts($args);

post_status参数可以控制具体的文章状态，值包括pending（待审）、publish（已发布）、draft（草稿）, future（定时）, private（私有）, trash（已删除）。

七、控制文章的数量

如果你想控制要显示的文章数量，可以使用showposts参数：

$paged = (get_query_var('paged')) ? get_query_var('paged') : 1; 

$args = array( 

// 控制只显示10篇文章，如果将10改成-1将显示所有文章

'showposts' => 10, 

'paged' => $paged 

); 

query_posts($args);

如果你只是想控制首页、分类页等每各分页显示的文章数量，可以在WordPress管理后台 – 设置 – 阅读那里设置博客页面至多显示多少篇文章