WordPress函数query_posts用法汇总

日期: 标签:WordPress教程 197 条留言
如需帮忙改代码,或者WordPress二次开发、PHP网站建设等需求,可联系我购买付费服务:  点此联系我
文章目录

最近经常有网友跟我咨询WordPress函数query_posts的相关用法,说起来query_posts实在是太强大,参数无数,用法更是无数,如果让我说它的用法,我根本没法一一说清楚。开始之前,你可以先看看query_posts的官方文档,query_posts的全部参数可以参考:WP_Query。不过看文档对很多人来说可能会很困难,本文将介绍几种常见的用法,不过一切用法都是从官方文档中来的,学会看文档才是王道。

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

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



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

如果你不想让某分类的文章出现在主循环中,那么你可以使用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将显示所有文章
    'posts_per_page' => 10,
    'paged' => $paged
);
query_posts($args);

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

-- 完 --

本文采用 「CC BY-NC-SA 4.0」创作共享协议,转载请标注以下信息:
原文出处:露兜博客 https://www.ludou.org/wordpress_query_posts.html
露兜
kaapass@outlook.com  QQ 825533758

业余编程爱好者,主业是淘宝店主,卖些工艺品,感兴趣可以到我的淘宝店看看(旺旺不提供技术咨询):西西弗sisyphe

197 条留言

点此留言
1 2 3 4 154
  1. 有点蓝

    百度一个功能,又找到这里了,露兜牛人啊

    • 露兜

      @有点蓝 能坚持做站这么多年,也不容易啊,一起努力!

      • 有点蓝

        @露兜 哎时间精力不太允许了,也没什么写博的动力,我这都快熬不住了,想转型呢。

  2. V21内衣加盟

    <?php
    $i = 1;
    query_posts( array(
    'post_type' => 'portfolio',
    'posts_per_page' => 4
    ));
    if ( have_posts() ) : while ( have_posts() ) : the_post();
    $short_desc = get_post_meta(get_the_ID(), 'tj_portfolio_short_desc', TRUE);
    ?>
    我想只显示tag id为4的portfolio 如何更改?

  3. im陈

    请问,怎么按照指定时间显示排序呢?比如一周内评论最多的文章

  4. im陈

    找到代码了,可以增加一个,本周文章排序。

    $args = array(
    'date_query' => array(
    array(
    'year' => date( 'Y' ),
    'week' => date( 'W' ),
    ),
    ),
    );
    $query = new WP_Query( $args );

  5. 第一次发

    露兜大神,看你博客有2个月了。给予我太多帮助了。感谢!!

    最近遇到一个问题,请帮忙看下。

    else if ( isset($_GET['order']) && ($_GET['order']=='commented') )
    {
    $paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
    $args=array(
    'meta_key' => 'specs_zan',
    'orderby' => 'meta_value_num',
    'paged' => $paged,
    'order' => DESC
    );

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

    }

    这一段代码是我调用赞数值进行文章排序的,有个问题就是把所有的文章都调出来了。怎么修改指定一个月内被赞过的文章进行排序呢?

  6. haha

    【联系内容已不正确】留言如下:
    'showposts' => 10,
    array中的这个参数,已经被posts_per_page代替了。

  7. 有事没事百度一下

    大神你好,遇上个问题没有太好的思路。
    我需要在一个详情页面里面调用一个自定义页面里的内容,这些内容都是通过加字段的方式添加的,并且另加了个推荐单选按钮字段。我要在详情页面调用的就是推荐的值为yes的几条记录('tj'=>'yes')不知道该怎么调呢?

    • 露兜

      @有事没事百度一下 你的描述不太清楚,也没法给你提供进一步的参考。
      所谓字段就是编辑页面中的自定义栏目?如果是要获得含有指定名称和指定值栏目的文章id,可以使用SQL来获取:
      SELECT * FROM `wp_postmeta` WHERE `meta_key` = 'tj' AND `meta_value` = 'ys';

  8. 随之长风

    大神求指点,如何循环出自定义文章类型的文章出来,比如自定义了一个公告页面,如何循环出来??

  9. 木先森

    请教个问题,为了能够文章分页显示,我把博客设为每页显示6篇文章,结果归档页面也只显示6篇,这种问题解决思路应该是修改归档archive的代码,具体怎么改呢?谢谢

  10. 木先森

    每次遇到wp难题,都是到露兜这里来解惑。

1 2 3 4

发表留言