WordPress自定义查询wp_query参数详细注释

开发WordPress主题，用得最多的就是wp_query这个万能的文章查询类，目前网上很难找到完整、全面的详细注解。我们在WordPress官方文章的相关资源里找到了详细的内容，国外有人把wp_query所有的参数做了一个总结，然后注释了一下，可惜是英文的，幸运的是我能看得懂，所有就顺便翻译了一下，供有需要的朋友查阅使用。有翻译不正确的地方，欢迎在留言中提出，我会及时更正。

WordPress 查询综合参考

官方文档: http://codex.wordpress.org/Class_Reference/WP_Query

源代码: http://core.trac.wordpress.org/browser/tags/3.5.1/wp-includes/query.php

快捷代码：

	

	//////偏移参数

	'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();

	 

	?>