在wordpress主题开发中获取文章列表内容是最基本的功能需求了，在分类列表模板页我们可以简单的使用一下代码就可以实现。
<?PHP while(have_posts()):the_post();?>
<?PHP endwhile; ?>
但是如果我们在分类列表模板页需要定制化输出文章列表，比如按照浏览量排序，或者我们需要在首页或其他自定义页面输出指定分类下的文章列表，那么以上代码就不行了。我们可以使用wordpress自带的WP_Query类来实现。使用WP_Query类我们可以定制出丰富多样的文章列表，比如热门文章列表，最新文章列表，带有日期筛选的文章列表，自定义文章类型文章列表，指定自定义分类法的文章列表等等。
WP_Query使用示例代码如下：
<?PHP
$args = array(
// 用于查询的参数或者参数集合，个性的文章查询关键就在这里了
);
$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();
?>
代码中$args是定义的参数变量，而变量$the_query是WP_Query类的一个实例，然后通过WP_Query的方法开始查询。
WP_Query的所有参数
<?PHP
/**
*
* 官方文档: http://codex.wordpress.org/Class_Reference/WP_Query
* 源代码: http://core.trac.wordpress.org/browser/tags/3.5.1/wp-includes/query.PHP
*/
$args = array(
/**
*/
'author' => '1,2,3,' //(整数) - 作者ID [使用减号 (-) 排除某个作者 ID， 如： 'author' => '-1,-2,-3,']
'author_name' => 'authorname',//(字符串) - 使用 'user_nicename' 用户昵称，(不是名称)
/**
*/
'cat' => 5,//(整数) - 分类id
'category_name' => 'staff','news',//(字符串) - 分类别名(不是名称)
'category__and' => array( 2,6 ),//(数组) - 分类id
'category__in' => array( 2,//(数组) - 分类id
'category__not_in' => array( 2,//(数组) - 分类id
/**
*/
'tag' => 'cooking',//(字符串) - 标签别名
'tag_id' => 5,//(整数) -标签ID
'tag__and' => array( 2,6),//(数组) - 标签ID
'tag__in' => array( 2,//(数组) - 标签ID
'tag__not_in' => array( 2,//(数组) - 标签ID
'tag_slug__and' => array( 'red','blue'),//(数组) - 标签别名
'tag_slug__in' => array( 'red',//(数组) - 标签别名
/**
* 重要提示: 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,3),//(数组) - 需要显示的文章的id
'post__not_in' => array(1,//(数组) - 需要排除的文章的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'
'pending',// -等待复审的文章
'draft',// - 处于草稿状态的文章
'future',// - 定时发布的文章
'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' 拥有文章分页或内容中使用 <!--nextpage--> 快捷代码的分页。
/**
* 偏移参数
*/
'offset' => 3,//(int) - 跳过的文章数量
/**
*/
'order' => 'DESC',//(字符串) - 设置 'order_by' 参数升序或降序排列. 默认为'DESC'.
//Possible Values:
//'ASC' - 升序排列，从小到大 (1,3; a,b,c).
//'DESC' - 降序排列，从大到小 (3,1; c,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,34,4,56,6,etc,而不是你希望的：1,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','BETWEEN',or 'NOT BETWEEN')
'type' => 'CHAR',//(字符串) -自定义字段类型，可用的值有：'NUMERIC','BINARY','CHAR','DATE','DATETIME','DECIMAL','SIGNED','TIME','UNSIGNED'，默认为 'CHAR'
'compare' => '=' //(字符串) - 测试的操作，可用的值有： '=','!=','<=','LIKE','NOT LIKE','IN','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();
?>
WP_Query运用实例
<?PHP
$args=array(
'Meta_key' => 'views',
'orderby' => 'Meta_value_num',
'posts_per_page'=>15,
'order' => 'DESC',
);
$the_query = new WP_Query( $args );
?>
<?PHP if ( $the_query->have_posts() ) : while ( $the_query->have_posts() ) :$the_query->the_post(); ?>
<a class="index-news-part" href="<?PHP%20the_permalink();?>" title="<?PHP the_title();?>">
<?PHP the_title();?>
</a>
<?PHP endwhile;endif;wp_reset_postdata();?>
版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 [email protected] 举报，一经查实，本站将立刻删除。
