说说WordPress的主查询函数-query_posts()
今天说说WordPress 的主查询函数 -query_posts(),因为我正在制作的主题里面多次用到了这个函数 。
query_posts()查询函数决定了哪些文章出现在WordPress 主 循环(loop)中,正因为如此,query_posts函数仅用于修改主页循环(Loop),而不是在页面上生成次级循环。如果你希望在主循环外另外生 成循环,应该新建独立的WP_Query对象,用这些对象生成循环。在主循环外的循环上使用query_posts会导致主循环运行偏差,并可能在页面上 显示出你不希望看到的内容。
query_posts()查询函数函数接收大量参数,格式与URL中的参数格式相同(如p=4表示ID为4的文章)。下面就举例说说query_posts函数的一些常用的语法格式。
1.从博客主页上排除某些分类目录
将以下代码添加到index.php文件中,使主页显示的文章可以来自除分类3以外的任何分类。
- <?php
- if (is_home()) {
- query_posts("cat=-3");
- }
- ?>
你也可以多排除几个分类。
- <?php
- if (is_home()) {
- query_posts("cat=-1,-2,-3");
- }
- ?>
2.查询指定文章
用以下语句检索某篇指定文章:
- <?php
- //获取ID值为5的文章
- query_posts('p=5');
- ?>
如果你希望在查询语句中使用Read More功能,请将全局变量$more设为0。
- <?php
- //获取ID值为5的页面
- query_posts('p=5');
- global $more;
- //初始化$more
- $more = 0;
- //循环查询到的结果
- while (have_posts()) : the_post();
- the_content('Read the full post ?');
- endwhile;
- ?>
3.检索指定页面
用以下语句检索某篇指定页面:
- <?php
- query_posts('page_id=7'); //获取页面ID为7的页面
- ?>
或者
- <?php
- query_posts('pagename=about');
- ?>
检索子页面时,需要提供子页面及其父页面的别名,用斜线隔开两者。例如:
- <?php
- query_posts('pagename=parent/child');
- ?>
上面都是采取 query_posts($query_string) 的形式来调用该函数,下面介绍另一种方法,用数组传递参数变量。
- query_posts(array(
- 'cat' => 22,
- 'year' => $current_year,
- 'monthnum' => $current_month,
- 'order' => 'ASC',
- ));
相比字符串方式,数组形式更加形象直观,不容易出错。
下面整理一些经常要用到的参数,有些是我用过的,有些则没有,算作归纳吧。
分类参数
只显示特定分类下的文章。
- cat —— 必须使用分类ID
- category_name
- category_and —— 必须使用分类ID
- category_in —— 必须使用分类ID
- category_not_in —— 必须使用分类ID
根据ID显示单个分类
只显示来自某一个分类目录ID(以及该分类目录下的子分类目录)的文章:
- query_posts('cat=4');
根据分类名称显示单个分类
只显示来自某一个分类名称下的文章:
- query_posts('category_name=Staff Home');
根据ID显示多个分类
显示来自若干指定分类目录ID下的文章:
- query_posts('cat=2,6,17,38');
排除某一分类中的文章
显示除某一分类文章外的所有文章,被排除的分类ID以减号(’-')作为前缀。
- query_posts('cat=-3');
以上代码删除ID为3的分类中的文章。
处理多个分类
显示隶属于多个分类的文章。下面的代码可展示同时属于分类2和分类6的文章:
- query_posts(array('category__and' => array(2,6)));
如果希望显示分类2或分类6中的文章,可以使用上面介绍的cat,也可以使用category_in函数 (注意这里不会显示分类下子分类中的文章) :
- query_posts(array('category__in' => array(2,6)));
可以用下面这种方式排除多个分类中的文章:
- query_posts(array('category__not_in' => array(2,6)));
标签参数
显示特定标签下的文章。
- tag —— 必须使用标签ID
- tag_id —— 必须使用标签ID
- tag_and —— 必须使用标签ID
- tag_in —— 必须使用标签ID
- tag_not_in —— 必须使用标签ID
- tag_slug_and ——必须使用标签ID
- tag_slug_in ——必须使用标签ID
获取某一标签中的文章
- query_posts('tag=cooking');
获取若干标签中任一标签中的文章
- query_posts('tag=bread+baking+recipe');
多个标签
显示同时属于ID为37和47的标签下的文章:
- query_posts(array('tag__and' => array(37,47));
若要显示ID为为37或47的标签下的文章,可以使用tag参数,也可以用tag_in:
- query_posts(array('tag__in' => array(37,47));
显示的文章既不属于标签37,也不属于标签47:
- query_posts(array('tag__not_in' => array(37,47));
tag_slug_in与tag_slug_and工作方式几乎一致,不同之处在于相匹配的别名不同。
作者参数
你也可以根据作者来选择文章。
- author=3
- author=-3 ——排除ID为3的作者所发表的文章
- author_name=Harriet
注意:author_name运行在user_nicename字段上,同时author运行在author id字段上。
显示ID为1的作者所发表的所有页面,以标题顺序排列页面,页面列表上方无置顶文章:
- query_posts('caller_get_posts=1&author=1&post_type=page&post_status=publish&orderby=title&order=ASC');
文章&页面参数
检索单篇文章或页面。
- ‘p’ => 27 —— 通过文章ID显示该文章
- ‘name’ => ‘about-my-life’ —— 对某篇文章的查询,查询中含有文章别名
- ‘page_id’ => 7 —— 对ID为7的页面的查询
- ‘pagename’ => ‘about’ —— 注意,这不是页面标题,而是页面路径
- 用’posts_per_page’ => 1 – use ‘posts_per_page’ => 3 展示3篇文章。用’posts_per_page’ => -1展示所有文章
- ‘showposts’ => 1 – use ‘showposts’ => 3 展示3篇文章。用’showposts’ => -1展示所有文章。已弃用。
- ‘post__in’ => array(5,12,2,14,7) —— 指定希望检索的文章ID
- ‘post__not_in’ => array(6,2,8) ——排除不希望检索的文章ID
- ‘post_type’ => ‘page’ ——返回页面;默认值为post;可用值包括any, attachment, page, post或revision。any可检索到除修订版外的所有页面类型。
- ‘post_status’ => ‘publish’ —— 返回已发布页面。可用值还包括pending, draft, future, private, trash。关于inherit请见get_children。trash状态新增于WordPress 2.9。
- ‘post_parent’ => 93 —— 返回页面93的子页面。
置顶文章参数
置顶文章功能引入于WordPress 2.7。在查询中,被设为“置顶”的文章会显示在其它文章之前,除非该文章已经被caller_get_posts=1 参数排除。
- array(‘post__in’=>get_option(‘sticky_posts’)) —— 返回所有置顶文章的数组
- caller_get_posts=1 —— 排除返回的文章上方的置顶文章,但在返回文章列表时,以自然顺序将曾经置顶的文章安插在列表中。
返回第一篇置顶文章
- $sticky=get_option('sticky_posts') ;
- query_posts('p=' . $sticky[0]);
或
- $args = array(
- 'posts_per_page' => 1,
- 'post__in' => get_option('sticky_posts'),
- 'caller_get_posts' => 1
- );
- query_posts($args);
注意:第二种方法只能返回最新发表的置顶文章;若当前无置顶文章,返回最新发表文章。
返回第一篇置顶文章;若无,则不返回任何内容
- $sticky = get_option('sticky_posts');
- $args = array(
- 'posts_per_page' => 1,
- 'post__in' => $sticky,
- 'caller_get_posts' => 1
- );
- query_posts($args);
- if($sticky[0]) {
- // insert here your stuff...
- }
从查询中排除所有置顶文章
- query_posts(array("post__not_in" =>get_option("sticky_posts")));
返回某一分类下所有文章,但不在文章列表上方显示置顶文章。所有设为“置顶”的文章以正常顺序(如日期顺序)显示
- query_posts('caller_get_posts=1&posts_per_page=3&cat=6');
返回某一分类下所有文章,完全不显示置顶文章,保留分页
- <?php
- $paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
- $sticky=get_option('sticky_posts');
- $args=array(
- 'cat'=>3,
- 'caller_get_posts'=>1,
- 'post__not_in' => $sticky,
- 'paged'=>$paged,
- );
- query_posts($args);
- ?>
时间参数
检索特定时间段内发表的文章。
- hour= -hour (时,-范围从0到23)
- minute= – minute (分,-范围从0到60)
- second= – second (秒,-范围从0到60)
- day= – day of the month (日,-范围从1到31)
- monthnum= – month number (月,-范围从1到12)
- year= – 4 digit year (年,如2009)
- w= – week of the year(一年中的第几周,-范围从0到53),使用 MySQL WEEK command Mode=1命令
返回最近发表的文章
- $today = getdate();
- query_posts('year=' .$today["year"] .'&monthnum=' .$today["mon"] .'&day=' .$today["mday"] );
返回12月20日发表的文章
- query_posts(monthnum=12&day=20' );
返回2009年3月1日到3月15日之间发表的文章
- <?php
- //based on Austin Matzko's code from wp-hackers email list
- function filter_where($where = '') {
- //posts for March 1 to March 15, 2009
- $where .= " AND post_date >= '2009-03-01' AND post_date < '2009-03-16'";
- return $where;
- }
- add_filter('posts_where', 'filter_where');
- query_posts($query_string);
- ?>
返回最近30天内发表的文章
- <?php
- //based on Austin Matzko's code from wp-hackers email list
- function filter_where($where = '') {
- //posts in the last 30 days
- $where .= " AND post_date > '" . date('Y-m-d', strtotime('-30 days')) . "'";
- return $where;
- }
- add_filter('posts_where', 'filter_where');
- query_posts($query_string);
- ?>
返回过去30天到过去60天内发表的文章
- <?php
- //based on Austin Matzko's code from wp-hackers email list
- function filter_where($where = '') {
- //posts 30 to 60 days old
- $where .= " AND post_date >= '" . date('Y-m-d', strtotime('-60 days')) . "'" . " AND post_date <= '" . date('Y-m-d', strtotime('-30 days')) . "'";
- return $where;
- }
- add_filter('posts_where', 'filter_where');
- query_posts($query_string);
- ?>
分页参数
- paged=2 ——显示点击“较早的日志”链接后出现在第二页中的文章
- posts_per_page=10 —— 每页所显示的文章数量;若值为-1,显示所有文章。
- order=ASC —— 按时间顺序显示文章,若值为DESC则按逆向时间顺序显示文章(默认)
offset(偏移)参数
通过offset参数,你可以移除或忽略正常情况下被查询集中的一篇或多篇初始文章。
以下显示最近一篇文章之后的5篇文章:
- query_posts('posts_per_page=5&offset=1');
排序参数
- orderby=author
- orderby=date
- orderby=category ——注意:该参数不能用于WordPress 2.8,可能已经被废止
- orderby=title
- orderby=modified
- orderby=menu_order
- orderby=parent
- orderby=ID
- orderby=rand
- orderby=meta_value —— meta_key=some value语句也应出现在查询参数中
- orderby=none – no order —— (新增于 WP 2.8)
- orderby=comment_count ——(新增于 WP 2.9)
顺序参数
决定以升序或降序排列排序参数
- order=ASC —— 升序,从最低值到最高值
- order=DESC —— 降序,从最高值到最低值
自定义字段参数
根据自定义关键字或值检索文章(或页面)。
- meta_key=
- metavalue=
- meta_compare= —— 用以测试metavalue=的操作符,默认值为 ‘=’,其它可能的值包括’!=’、 ‘>’、’>=’、 ‘<’或 ‘<=’ 。
返回关键字为 ‘color’ 且值为’blue’的文章:
- query_posts('meta_key=color&metavalue=blue');
返回自定义字段关键字为’color’的文章,无论自定义字段值为何:
- query_posts('meta_key=color');
返回自定义字段值为’color’的文章,无论关键字为何:
- query_posts('metavalue=color');
返回自定义字段值为’green’的页面,无论自定义字段关键字为何:
- query_posts('post_type=page&metavalue=green');
返回自定义关键字为’color’、自定义字段值不为’blue’的文章和页面:
- query_posts('post_type=any&meta_key=color&meta_compare=!=&metavalue=blue');
返回自定义字段关键字为’miles’、自定义字段值小于等于22的文章。注意,字段值99会被看做大于字段值100,因为数据是以字符串形式而不是数字形式存储的。
query_posts('meta_key=miles&meta_compare=<=&metavalue=22');
联合参数
你可能已经从上面有些例子中看出来了,可以用&符号连接不同参数,如:
- uery_posts('cat=3&year=2004');
显示主页上、当前月份发表的、隶属于分类13下的文章:
- if (is_home()) {
- query_posts($query_string . '&cat=13&monthnum=' . date('n',current_time('timestamp')));
- }
在WP 2.3中,以下参数联合会返回同时属于分类1和分类3的两篇文章,以文章标题降序排列:
- query_posts(array('category__and'=>array(1,3),'posts_per_page'=>2,'orderby'=>title,'order'=>DESC));
在WP 2.3和WP 2.5中,以下参数联合本应返回属于分类1且带有“apples”标签的文章:
- query_posts('cat=1&tag=apples');
但由于一个bug,代码没能显示出正常结果。有一个解决办法:利用+号查找多个标签:
- query_posts('cat=1&tag=apples+apples');
这就显示出我们希望显示的结果了。
使用技巧
设置>阅读中的“博客页面最多显示”参数会影响你的查询结果,要覆盖设置>阅读中的设置,需要在标签中添加’posts_per_page’ 参数。例如:
- query_posts('category_name=The Category Name&posts_per_page=-1'); //returns ALL from the category
注意:query_posts函数会改写并取代页面的主查询。为谨慎起见,请不要将query_posts用作其它用途。
来源: http://www.zuluo.net/2012/2012-01/wordpress-query_posts.html
转载于:https://www.cnblogs.com/kenshinobiy/p/7309233.html
说说WordPress的主查询函数-query_posts()相关推荐
- @many一对多---------解决一向多中主查询的数据库中没有的字段传递给子函数的问题
@many一对多---------解决一向多(主查询传递给子查询参数为两个) 方法运用场景 主函数传递参数给子查询进行条件查找 方法简述 将变量参数转化为动态列,通过常用列传值方法传入 主查询 @Ma ...
- 【数据结构】校园地图导航---主函数 景点查询函数
//主函数 int main() //主函数 {int k; //选择键init(); //初始化Welcome_Gui(); //欢迎界面int start, ends, n;while (1){f ...
- 学习WordPress必须知道的函数(转)
WordPress是目前十分流行的独立博客程序,因傻瓜化安装和使用,其在网民中的应用已近乎普及.但也因为很多新入门的用户几乎对WordPress 程序没有任何了解,造成使用中碰到问题无法解决,求助也十 ...
- 用好WordPress不可不知的函数(转)
想在网上找个WordPress的中文文档,未果,发现了这七篇不错的文章,编辑为一篇,发布于美拓的blog.文章转载自:月夜 [http://www.yueye.org] 用好WordPress不可不知 ...
- MapInfo中常用查询函数及用法
MapInfo中常用查询函数及用法: 函数用途 语法 备注 图层中选点 Str$(obj)="point": Str(String)表示字符串:point表示点: 图层中选线 St ...
- php mysql 时间戳查询_mysql中时间查询函数(包括时间戳)
mysql中时间查询函数(包括时间戳) 这些函数都是MySQL自带的,可以直接使用在PHP写的MySQL查询语句中哦 1-CURDATE()或CURRENT_DATE()和CURTIME()或CURR ...
- 判断一个where条件的对错php,sql – IN子查询的WHERE条件影响主查询 – 这是一个功能还是一个错误?...
假设有两个表: Table A: A1,A2,A_Other Table B: B1,B2,B_Other 在以下示例中,是针对固定值检查的条件,例如,='ABC'或< 45. 我写了一个如下( ...
- Hive _偏门常用查询函数(三)附带实例(Rank)
接上两篇博客 Hive _偏门常用查询函数(一)附带实例 https://blog.csdn.net/qq_41946557/article/details/102904642 Hive _偏门常用查 ...
- Hive _偏门常用查询函数(二)附带实例(列转行、窗口函数)
接上篇博客: Hive _偏门常用查询函数(一)附带实例 https://blog.csdn.net/qq_41946557/article/details/102904642 列转行 1.函数说明 ...
最新文章
- 美团开源Logan Web:前端日志在Web端的实现
- 自动化部署必备技能—定制化RPM包[转载]
- get_attribute中的value是什么类型的?_建设工程项目中都有什么类型的监理?
- Java后台请求远程链接
- VisualStudio.gitignore git 忽略
- 怎么查看mysql正在运行的语句_MySQL如何查询当前正在运行的SQL语句
- NVIDIA向交通运输行业开源其自动驾驶汽车深度神经网络
- java xml amp_Javaamp;Xml教程(十一)JAXB实现XML与Java对象转换
- CV Code | 计算机视觉开源周报20191002期
- java 中JFinal getModel方法和数据库使用出现问题解决办法
- Elasticsearch】es memory locking requested for process but memory is not locked
- linux hal-get-property进程说明,Android HAL property_get() 函数用法
- Linux NGINX 主备,使用keepalived实现主备(以nginx为例)
- 一个奇怪的MySQL慢查询,打懵了一群不懂业务的DBA!
- Docker备份镜像和重新载入镜像
- 【Excel 教程系列第 17 篇】如何根据图片名称自动查找出对应的图片
- 运营天猫商城的注意事项
- 华为路由器用Linux开发,华为路由交换设备配置综合实验(实验六合一)
- CSS网页布局中文排版的9则技巧
- 高洛峰mysql_【干货】MySQL 安装与安全优化
热门文章
- Linux-SNAT和DNAT
- 怎么改utf8_想重装python但有很多包怎么办?不要慌,教你如何快速重装
- hamming weight_popcount或者hamming weight(二进制1的个数问题)
- python学习笔记(十一)——正则表达式
- halcon初学者知识【16】如何将Image图象的区域拷贝出来?
- android与gradle版本,android – Gradle错误:支持的最低Gradle版本...
- 跨境电商自建站后台系统原型rp_没学历做跨境电商好做吗?虾皮shopee开店没有流水怎么办...
- 2021-02-06 Python通过matplotlib包和gif包生成gif动画
- 2020-12-18 Matlab LQR 推导及简单应用
- python3 time