示例
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
<?php $args = array( // 用于查询的参数或者参数集合 ); // 自定义查询 $query = new WP_Query( $args ); // 判断查询的结果 if ( $query->have_posts() ) { // 通过查询的结果，开始主循环 while ( $query->have_posts() ) { $query->the_post(); // Contents of the queried post results go here. } } // 重置请求数据 wp_reset_postdata(); ?> |
1、Loop循环传递不同的参数的时候使用wp_reset_postdata()，这样就可以在同一个页面上新建多个Loop循环（多重循环）。
2、includes/query.php中看到它的原码。
WP_Query参数
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 |
<?php /** * WordPress 查询综合参考 * 编译：luetkemj - luetkemj.com * * 官方文档: 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' => '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' 拥有文章分页或内容中使用 <!--nextpage--> 快捷代码的分页。 /** * 偏移参数 */ '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(); ?> |
WP_QUERY运用示例：
1、调用最新20篇post文章，并分页，每页显示10篇
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
<?php $args = array('post_type'=>'post','showposts'=>'10','posts_per_page'=>'10','paged'=>get_query_var('paged')); $recendposts = new WP_Query( $args ); if($recendposts->have_posts()) : while($recendposts->have_posts()) : $recendposts->the_post(); ?> <li><a href="<?php the_permalink() ?>" title="<?php the_title(); ?>"><?php the_title(); ?></a></li> <?php endwhile; endif; wp_reset_postdata(); ?> |
2、调用输出自定义文章类型某分类文章
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
<?php $args = array( 'post_type' => 'products', //自定义文章类型名称 'posts_per_page' => 4, //输出的文章数量，这个可以是缺省值，不用设置 'tax_query' => array( array( 'taxonomy' => 'products-category',//自定义分类法名称 'terms' => 10, //id 为 64 的分类。也可是多个分类 array(12,64) ), ) ); $my_query = new WP_Query($args); if( $my_query->have_posts() ) { while ($my_query->have_posts()) : $my_query->the_post();?> <div class="sypbox"> <a href="<?php the_permalink(); ?>" class="syptu"> <img src="<?php echo post_thumbnail_src(); ?>" alt="<?php the_title();?>"> </a> <a href="<?php the_permalink(); ?>" class="sypp"> <?php the_title();?> </a> </div> <?php endwhile; wp_reset_query(); //重置 query 查询 } ?> |
3、搜索查询
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
<?php // $where = array('cat'=>1,'posts_per_page'=2); // $where = array('author'=>1); $where = array('s'=>'工具','post_type'=>'post'); $the_query = new WP_Query( $where ); var_dump($the_query); // 开始循环 if($the_query->have_posts()){//如果找到了结果，便输出以下内容 echo '<ul>'; while ( $the_query->have_posts() ) { //再次判断是否有结果 $the_query->the_post(); //不用问为什么，每次都要写这个； ?> <li><a href="<?php the_permalink();?>"><?php the_title();?></a></li> <?php } echo '</ul>'; } else { echo "没有找到相关的文章"; } wp_reset_postdata(); ?> |
结合PHP的流程控制对上面的代码进行改造：
|
1 2 3 4 5 6 7 8 9 |
<?php $where = array('s'=>'工具','post_type'=>'post'); ?> <?php $the_query = new WP_Query( $where ); ?> <?php if($the_query->have_posts()):?> <?php while ($the_query->have_posts()) : $the_query->the_post();?> <a href="<?php the_permalink();?>"><?php the_title();?></a><br> <?php endwhile; ?> <?php else : ?> //此处显示未找到文章时的信息，比如404相关 <?php endif; ?> |
查询5条浏览量最多的：
|
1 2 3 4 5 6 7 8 9 |
<?php $where = array('s'=>'工具','post_type'=>'post','order'=>'DESC','meta_key'=>'views','orderby'=>'meta_value_num','posts_per_page'=>1); ?> <?php $the_query = new WP_Query( $where ); ?> <?php if($the_query->have_posts()):?> <?php while ($the_query->have_posts()) : $the_query->the_post();?> <a href="<?php the_permalink();?>"><?php the_title();?></a><br> <?php endwhile; ?> <?php else : ?> //此处显示未找到文章时的信息，比如404相关 <?php endif; ?> |
WP_Query 相关的函数
1、获取公用的查询参数：get_query_var()
2、关联主循环：query_post()
3、获取一篇文章：get_post()
4、保存查询结果到数组中：get_posts()
5、获取页面：get_pages()
6、判断查询是否返回了文章：have_posts()
7、运行loop循环：the_post()
8、建立$post数据：setup_postdata()
9、清除当前的loop循环：rewind_posts()
10、重置$post：wp_reset_postdata()
11、重置查询： wp_reset_query()
12、判断是否当前查询为主查询：is_main_query()
13、判断是否在loop循环中：in_the_loop()
总共0 条评论。