WordPress函数is_main_query是主查询吗?

WordPress函数is_main_query是主查询吗?is_main_query()函数是一个开发者常用的函数,它能帮助WordPress主题或者插件开发者确定当前查询是主查询还是辅助查询,以便于开发者使用不同逻辑。使用这个函数可以帮助我们实现WordPress提速优化,达到0sql的效果。

WordPress函数is_main_query是主查询吗?

函数介绍

is_main_query()

用以确定查询是否为主查询。

返回值

是主查询返回true,不是返回false。

官方描述

is_main_query()函数是一个条件函数,可用于计算当前查询(例如循环中的查询)是否是“主”查询(与辅助查询相反)。这个函数在钩子中最常用,用于区分WordPress的主查询(用于页面、POST或归档)和自定义/辅助查询。is_main_query()可以与前端查询(主题模板、插件等)以及管理查询一起使用。如果当前查询是主查询,则返回true;如果不是,则返回false。

此WordPress函数不接受任何参数。相反,它会自动将$wp_query对象(即“当前查询”)与$wp_the_query对象(“主查询”)进行比较,该函数是WP_Query类下is_main_query()方法的别名。在传递WP_Query对象(如‘preget_post’)的Filter或action挂钩回调中,调用此函数是循环的。相反,直接调用传递对象的方法。例如,如果您的过滤器回调将传递的WP_Query对象分配给$query,您将调用如下方法:$query->is_main_query()。

add_action( ‘pre_get_posts’, ‘foo_modify_query_exclude_category’ );

function foo_modify_query_exclude_category( $query ) {

if ( ! is_admin() && $query->is_main_query() && ! $query->get( ‘cat’ ) )

$query->set( ‘cat’, ‘-5’ );

}

使用WP_Query->is_main_query()代替is_main_query()(无效)的示例

/**

* If the global query is for a category, exclude category 5.

*

* @param WP_Query $query Global WP_Query instance.

*/

function wpdocs_modify_query_exclude_category( $query ) {

if ( ! is_admin() && $query->is_main_query() && ! $query->get( ‘cat’ ) )

$query->set( ‘cat’, ‘-5’ );

}

add_action( ‘pre_get_posts’, ‘wpdocs_modify_query_exclude_category’ );

小车博客下载必看

给TA打赏
共{{data.count}}人
人已打赏
WP教程

使用接口方式获取WordPress用户信息的方法

2020-7-13 10:12:50

WP教程

WordPress设置Apache和Nginx的伪静态规则

2020-7-13 10:38:15




重要声明

本站资源来自会员发布以及互联网收集,不代表本站立场,如有侵犯你的权益请联系管理员-车车站内发信联系 我们会第一时间进行审核删除。站内资源为网友个人学习或测试研究使用,未经原版权作者许可,禁止用于任何商业途径!请用户仔细辨认内容的真实性,避免上当受骗!本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。请在下载24小时内删除!


如果遇到付费才可观看的文章,建议升级终身VIP。全站所有资源任意下免费看”。本站资源少部分采用7z压缩,为防止有人压缩软件不支持7z格式,7z解压,建议下载7-zip,zip、rar解压,建议下载WinRAR

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索