动作钩子::在创建查询变量对象之后,但在运行实际查询之前激发。
do_action_ref_array( ‘pre_get_posts’, WP_Query $this )
说明(Description)
注意:如果使用条件标记,请使用传递实例中的方法版本(例如$this->is_main_query(),而不是is_main_query())。这是因为像is_main_query()这样的函数针对全局$wp_query实例进行测试,而不是通过的实例。
参数(Parameters)
参数 | 类型 | 说明 |
---|---|---|
$this | (WP_Query) | WP_查询实例(通过引用传递)。 |
更新版本 | 源码位置 | 使用 | 被使用 |
---|---|---|---|
2.0.0 | wp-includes/class-wp-query.php:1772 | 1 | 0 |