> WordPress中文手册 > wordpress query_posts函数应用介绍

做过WordPress模版开发的都知道query_post()函数是wordpress最常用的函数之一,比如读取最新文章,读取指定分类文章,读取指定标签文章等等都用到了query_post()函数。下面让我们来看几个关于query_post()的实际应用。

wordpress按评论数获取文章

<?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添加参数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管理后台 – 设置 – 阅读那里设置博客页面至多显示多少篇文章。

读取指定分类的文章

读取分类ID为4的文章:

query_posts('cat=4');

更多文章分类检索请查看:wordpress读取指定分类文章