WordPress 主查询函数 query_posts

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

基本用法：

首先介绍一下如何使用 query_posts 函数。在主题目录下找到存档页面文件，存档页面包括 index.php 、 archive.php 等，一般分类页、标签页、日期页和作者页等都是用 archive.php，具体的 WordPress 主题文件构成可以看这篇文章：WordPress 主题文件构成

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

<?php

// query_posts 函数
query_posts('orderby=comment_count');

// 主循环
if ( have_posts() ) : while ( have_posts() ) : the_post();
..
endwhile; else:
..
endif;

// 重置 query
wp_reset_query();

?>

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

$args = array(
 // query_posts 参数，具体参数可以参加官方文档
 'orderby'   => comment_count
 );// 下面这一行代码是必须的，不然不能分页
 $arms = array_merge($args, $wp_query->query);
 query_posts($arms);

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

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

我们常见的 WordPress 站点文章排序，通常情况下是按发布时间的升序或降序方式排列，这种排序方式几乎可以满足大多数站点的需求了，但是有些另类的站点可能会有一些另类的需求：我想手动修改文章的排列方式，可以随意更改文章的排列位置。其实 WordPress 的 query_posts 就可以轻松解决这个问题，不过你得自己动手改一些代码。

修改方法：

1 、打开 WordPress 当前主题要修改的 php 文件，搜索代码：

while (have_posts())

将其替换成：

/**
 * 名称：WordPress 手动修改文章排列顺序
 */

$args = array(
    'meta_key' => 'sort',
    'orderby'   => 'meta_value_num',  // 须 WordPress 2.8 及以上版本
    'order' => DESC
);
$arms = array_merge($args, $wp_query->query);

query_posts($arms);
while (have_posts())

接着搜索：

endwhile;

将其改成：

endwhile;wp_reset_query();

2 、给之前发表的所有文章添加自定义字段（或者称作自定义栏目，在文章编辑页底部可以看到），名称为 sort ，值填数字。这样在首页，文章的排列顺序就按照 sort 字段的值，从大到小排列了。通过修改 sort 字段的值，可以达到自定义文章排列顺序的目的。

3 、需要注意的是，通过以上修改后，你必须给所有文章添加自定义字段 sort，否则没有添加 sort 字段的文章将无法在首页显示。这也许就是手动排序需要付出的代价吧，要不然何谓手动？

4 、如果你同时想手动修改标签页、分类页等存档页面的文章排列顺序，同样可以按照第一步介绍的方法来操作，修改主题目录下的 archive.php 等。

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

让访客自行选择文章排序方式

其实实现过程也比较简单，一个是构造链接，另外一个是使用 query_posts 来改变一下主循环就可以了。

构造链接

链接主要用于传递 GET 参数，让 PHP 程序知道你到底想怎么排序。在主题的 index.php 中你需要的位置插入以下代码，用于输出排序按钮的 HTML，这个排序按钮的样式，你再自己写写 css 咯。需要注意的是以下代码会自动获取当前用户已选择的排序方式，并给这个排序按钮的 li 添加了 class=」current」：

<h4> 文章排序</h4>
 <ul>
 <li><a <?php if ( isset($_GET['order']) && ($_GET['order']=='rand') ) echo ''; ?> href="<?php%20echo%20get_option('home');%20?>/?order=rand" rel="nofollow"> 随机阅读</a></li>
 <li><a <?php if ( isset($_GET['order']) && ($_GET['order']=='commented') ) echo ''; ?> href="<?php%20echo%20get_option('home');%20?>/?order=commented" rel="nofollow"> 评论最多</a></li>
 <li><a <?php if ( isset($_GET['order']) && ($_GET['order']=='alpha') ) echo ''; ?> href="<?php%20echo%20get_option('home');%20?>/?order=alpha" rel="nofollow"> 标题排序</a></li>
 </ul>

改变主循环

首先你得先在主题的 index.php 中找到以下语句：

if (have_posts())

然后在这句之前添加以下代码：

if ( isset($_GET['order']) )
{
switch ($_GET['order'])
{
case 'rand' : $orderby = 'rand'; break;
case 'commented' : $orderby = 'comment_count'; break;
case 'alpha' : $orderby = 'title'; break;
default : $orderby = 'title';
}
global $wp_query;
$args= array('orderby' => $orderby, 'order' => 'DESC');

$arms = array_merge($args, $wp_query->query);
query_posts($arms);
}

if (have_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,
 'ignore_sticky_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 管理后台 – 设置 – 阅读那里设置博客页面至多显示多少篇文章。

WordPress 主查询函数 query_posts