WordPress自定义查询WP_Query参数使用说明

你的名字 2021-09-08 17:02 453阅读 0赞

<?php  
/\*\*  
\* WordPress 查询综合参考  
\*/

$args = array(

/\*\*  
\* 作者参数 - 显示某些作者发表的文章  
\*/  
'author' => '1,2,3,' //(整数) - 作者ID \[使用减号 (-) 排除某个作者 ID， 如： 'author' => '-1,-2,-3,'\]  
'author\_name' => 'luetkemj', //(字符串) - 使用 'user\_nicename' 用户昵称，(不是名称)

/\*\*  
\* 分类参数 - 显示某个分类里面的文章  
\*/  
'cat' => 5,//(整数) - 分类id  
'category\_name' => 'staff', 'news', //(字符串) - 分类别名(不是名称)  
'category\_\_and' => array( 2, 6 ), //(数组) - 分类id  
'category\_\_in' => array( 2, 6 ), //(数组) - 分类id  
'category\_\_not\_in' => array( 2, 6 ), //(数组) - 分类id

/\*\*  
\* 标签参数 - 显示含有某些标签的文章  
\*/  
'tag' => 'cooking', //(字符串) - 标签别名  
'tag\_id' => 5, //(整数) -标签id  
'tag\_\_and' => array( 2, 6), //(数组) - 标签id  
'tag\_\_in' => array( 2, 6), //(数组) - 标签id  
'tag\_\_not\_in' => array( 2, 6), //(数组) - 标签id  
'tag\_slug\_\_and' => array( 'red', 'blue'), //(数组) - 标签别名  
'tag\_slug\_\_in' => array( 'red', 'blue'), //(数组) - 标签别名

/\*\*  
\* 自定义分类法参数 - 显示某些自定义分类法里面的文章  
\* 重要提示: tax\_query 使用多维数组  
\* 这种查询结构允许我们查询多个自定义分类法  
\*/  
'tax\_query' => array( //(数组) - 使用自定义分类法查询参数 (3.1及以后版本可用).  
  'relation' => 'AND', //(字符串) - 可用的值有 'AND' 或 'OR' 和 SQL 的 JOIN 作用是相同的  
  array(  
    'taxonomy' => 'color', //(字符串) - 自定义分类法  
    'field' => 'slug', //(字符串) - 使用别名还是分类作为查询条件 ('id' 或 'slug')  
    'terms' => array( 'red', 'blue' ), //(整数/字符串/数组) - 自定义分类法分类条目  
    'include\_children' => true, //(布尔值) - 是否包含自分类，默认为真  
    'operator' => 'IN' //(字符串) - 测试条件，可用值为 'IN', 'NOT IN', 'AND'.  
  ),  
  array(  
    'taxonomy' => 'actor',  
    'field' => 'id',  
    'terms' => array( 103, 115, 206 ),  
    'include\_children' => false,  
    'operator' => 'NOT IN'  
   )  
),

/\*\*  
\* 文章 & 页面参数- 基于文章或页面参数显示文章  
\*/  
'p' => 1, //(整数) - 文章id  
'name' => 'hello-world', //(字符串) - 文章别名  
'page\_id' => 1, //(整数) - 页面id  
'pagename' => 'sample-page', //(字符串) - 页面别名  
'pagename' => 'contact\_us/canada', //(字符串) - 用斜杠‘/’分割的父页面别名/子页面别名来显示子页面  
'post\_parent' => 1, //(整数) - 页面id，只返回子页面，只对有子页面的页面有效  
'post\_\_in' => array(1,2,3), //(数组) - 需要显示的文章的id  
'post\_\_not\_in' => array(1,2,3), //(数组) - 需要排除的文章的id  
//注意：不能在同一个查询里同时使用 'post\_\_in' 和 'post\_\_not\_in'

/\*\*  
\* 文章类型 & 状态参数 - 显示某些文章类型里面的文章  
\*/  
'post\_type' => array( //(字符串/ 数组) - 文章类型，根据文章类型获取文章，默认为'post'  
    'post', // - 文章  
    'page', // - 页面  
    'revision', // - 文章版本  
    'attachment', // - 附件，默认 WP\_Query 设置了发布状态为 'post\_status'=>'published', 但是附件默认为 'post\_status'=>'inherit'，所以你需要设置状态为 'inherit' 或'any'.  
    'my-post-type', // - 自定义文章类型 (例如：movies)  
),  
'post\_status' => array( //(字符串 / 数组) - 使用文章状态，根据文章状态获取文章，默认为 'publish'  
    'publish', // - 已发布的文章或页面  
    'pending', // -等待复审的文章  
    'draft', // - 处于草稿状态的文章  
    'auto-draft', // - 自动保存为草稿的文章  
    'future', // - 定时发布的文章  
    'private', // - 未登录用户不能查看的私有文章  
    'inherit', // - 版本. 具体参考 get\_children.  
    'trash' // - 回收站中的文章 (2.9和以后的版本可用).  
),

//注意：The 'any' 关键字可以用在 post\_type 和 post\_status 查询，但是不能在数组中使用  
'post\_type' => 'any', // - 获取所有文章类型里面的文章，除了版本和文章类型参数'exclude\_from\_search'设置为true的文章类型  
'post\_status' => 'any', // - 获取处于所有文章状态的文章，除了版本和文章类型参数'exclude\_from\_search'设置为true的文章类型

/\*\*  
\* 分页参数  
\*/  
'posts\_per\_page' => 10, //(整数) - 每页显示的文章数量 (2.1和以后的版本可用)， 使用'posts\_per\_page'=-1 显示所有文章，如果查询处于订阅源中，WordPress用 'posts\_per\_rss' 选项覆盖了这里的设置，需要使用这个限制，尝试使用 'post\_limits' 过滤器，或使用 'pre\_option\_posts\_per\_rss'过滤器返回 -1  
'posts\_per\_archive\_page' => 10, //(整数) - n每页显示的文章数量 - 只在存档页面使用，在存档页面和搜索结果页面覆盖了 showposts 和 posts\_per\_page 参数  
'nopaging' => false, //(布尔值) - 在一页显示所有文章或使用分页，默认值为 'false', 使用分页  
'paged' => get\_query\_var('paged'), //(整数) - 页数，分页时显示第几页  
//注意：使用 get\_query\_var('page'); 如果查询在设置为首页的页面模版中工作，查询参数 'page' 拥有文章分页或内容中使用  快捷代码的分页。

/\*\*  
\* 偏移参数  
\*/  
'offset' => 3, //(int) - 跳过的文章数量

/\*\*  
\* 排序 & 排序方式参数 - 对获取的文章进行排序  
\*/  
'order' => 'DESC', //(字符串) - 设置 'order\_by' 参数升序或降序排列. 默认为'DESC'.  
//Possible Values:  
//'ASC' - 升序排列，从小到大 (1, 2, 3; a, b, c).  
//'DESC' - 降序排列，从大到小 (3, 2, 1; c, b, a).  
'orderby' => 'date', //(字符串) - 排序依据. 默认为 'date'.  
//可用的参数有://  
//'none' - 不排序 (2.8和以后的版本可用)  
//'ID' - 根据ID排序，注意ID是大写的  
//'author' - 根据作者排序  
//'title' - 根据标题排序  
//'date' - 根据发表时间排序  
//'modified' - 根据最后修改时间排序  
//'parent' - 根据父页面排序  
//'rand' - 随机排序  
//'comment\_count' - 根据评论数量排序 (2.9和以后的版本可用).  
//'menu\_order' - 根据页面序号排序. 通常在页面中使用 (编辑页面时有一个页面序号的字段) 和附件 ( 插入 / 上传媒体相册对话框中的数字), 但是不能对文章类型 'menu\_order' 使用数字值 (默认都为 0).  
//'meta\_value' - 注意'meta\_key=keyname' 必须也出现在查询中. 注意排序是按照字母表顺序进行的。(如：words),但是数字排序可能会有问题 (如：1, 3, 34, 4, 56, 6, etc, 而不是你希望的：1, 3, 4, 6, 34, 56)。  
//'meta\_value\_num' - 根据数字meta值排序 (2.8和以后的版本中可用). 同时需要注意'meta\_key=keyname' 也要在查询中声明。这个值和上面说明的 'meta\_value' 一样，只不过值允许使用数字排序。  
//'title menu\_order' - 同时使用 menu\_order 和 title 排序 更多信息请参考：http://wordpress.stackexchange.com/questions/2969/order-by-menu-order-and-title  
//'post\_\_in' - 使用 post\_\_in 数组中制定的 ID 顺序 (3.5以后的版本中可用).

/\*\*  
\* 置顶文章参数 - 显示或忽略置顶文章  
\*/  
'ignore\_sticky\_posts' => false, //(布尔值) - 是否忽略置顶文章，默认为假不忽略. 在返回文章的开头忽略/排除置顶文章,但是置顶文章还是会在自然查询中列出。  
//注意：关于置顶文章的更多信息，请参考：http://codex.wordpress.org/Class\_Reference/WP\_Query\#Sticky\_Post\_Parameters

/\*\*  
\* 时间参数 - 显示某个时间段内的文章  
\*/  
'year' => 2012, //(int) - 4 个数字的年份 (如：2011)  
'monthnum' => 3, //(int) - 月份数字 (从 1 到 12)  
'w' => 25, //(int) - 一年中的第几周 (从 0 到 53)， 使用 MySQL WEEK 命令，此模式和"start\_of\_week" 选项相关  
'day' => 17, //(int) - 月中的天数 (从 1 到 31)  
'hour' => 13, //(int) - 小时 (从 0 到 23).  
'minute' => 19, //(int) - 分钟 (从 0 到 60).  
'second' => 30, //(int) - 秒 (从 0 到 60).

/\*\*  
\* 自定义字段参数 - 显示拥有某个自定义字段的文章  
\*/  
'meta\_key' => 'key', //(字符串) - 自定义字段的键  
'meta\_value' => 'value', //(字符串) - 自定义字段的值  
'meta\_value\_num' => 10, //(数字) - 自定义字段的值  
'meta\_compare' => '=', //(字符串) - 测试'meta\_value'的操作。可用的值有'!=', '>', '>=', '<', or ='. 默认为 '='.  
'meta\_query' => array( //(数组) - 自定义字段参数 (3.1和以后的版本可用).  
array(  
    'key' => 'color', //(字符串) - 自定义字段的键  
    'value' => 'blue', //(字符串/数组) - 自定义字段的值 (注意：数组的支持仅限于一个比较值： 'IN', 'NOT IN', 'BETWEEN', or 'NOT BETWEEN')  
    'type' => 'CHAR', //(字符串) -自定义字段类型，可用的值有：'NUMERIC', 'BINARY', 'CHAR', 'DATE', 'DATETIME', 'DECIMAL', 'SIGNED', 'TIME', 'UNSIGNED'，默认为    'CHAR'  
    'compare' => '=' //(字符串) - 测试的操作，可用的值有： '=', '!=', '>', '>=', '<', '<=', 'LIKE', 'NOT LIKE', 'IN', 'NOT IN', 'BETWEEN', 'NOT BETWEEN'. 默认为：'='  
),  
array(  
    'key' => 'price',  
    'value' => array( 1,200 ),  
    'compare' => 'NOT LIKE'  
)

/\*\*  
\* 权限参数 - 显示已发布文章，如果用户有合适的权限，同样现实私有文章:  
\*/  
'perm' => 'readable' //(字符串) 可用的值有：'readable', 'editable' (可能还有其他可用的值我没有测试)

/\*\*  
\* 与缓存相关的参数  
\*/  
'no\_found\_rows' => false, //(布尔值) 默认为假，为了分页，WordPress 在大多数查询中使用 SQL\_CALC\_FOUND\_ROWS 查询， 即使你不需要分页，通过设置这个参数为真，我们告诉了了WordPress不要查询数据总行数，从而降低数据库负载，如果设置了这个参数为真，分页将不工作，更多信息请参考：http://flavio.tordini.org/speed-up-wordpress-get\_posts-and-query\_posts-functions  
'cache\_results' => true, //(布尔值) 默认为真  
'update\_post\_term\_cache' => true, //(布尔值) 默认为真  
'update\_post\_meta\_cache' => true, //(布尔值) 默认为真  
//注意：缓存是个好东西，通常不建议设为假，更多信息请参考：http://codex.wordpresorg/Class\_Reference/WP\_Query\#Permission\_Parameters

/\*\*  
\* 搜索参数  
\*/  
's' => $s, //(字符串) - 传递搜索变量到搜索功能，更多信息请参考： http://www.wprecipes.com/how-to-display-the-number-of-results-in-wordpress-search  
'exact' => true //(布尔值) - 只匹配完整的titles/posts的信号 - 默认值为假，更多信息请参考：https://gist.github.com/2023628\#gistcomment-285118  
'sentence' => true //(布尔值) - 进行短语搜索的信号-默认值为假，更多信息请参考：https://gist.github.com/2023628\#gistcomment-285118

/\*\*  
\* 文章字段参数  
\*/  
//关于文章字段参数信息，请参考http://codex.wordpress.org/Class\_Reference/WP\_Query\#Post\_Field\_Parameters

/\*\*  
\* 过滤器  
\*/  
//关于过滤器的更多信息，请参考：http://codex.wordpress.org/Class\_Reference/WP\_Query\#Filters

);

$the\_query = new WP\_Query( $args );

// 循环开始  
if ( $the\_query->have\_posts() ) :  
    while ( $the\_query->have\_posts() ) : $the\_query->the\_post();  
        // 输出内容  
    endwhile;  
endif;

// 重置文章数据  
wp\_reset\_postdata();