钩子文档

parse_query

💡 云策文档标注

概述

parse_query 是一个 WordPress 动作钩子,在 WP_Query::parse_query() 方法解析查询变量后触发,允许开发者修改查询条件。

关键要点

  • parse_query 是一个动作钩子,在 WP_Query::parse_query() 执行后触发。
  • 它传递一个 WP_Query 实例作为参数,可用于设置自定义查询变量(如 is_ 变量)。
  • 此钩子自 WordPress 1.5.0 版本引入。

代码示例

function wpdocs_set_custom_isvars( $query ) {
   $query->is_foo = ...
}
add_action( 'parse_query', 'wpdocs_set_custom_isvars' );

📄 原文内容

Fires after the main query vars have been parsed.

Parameters

$queryWP_Query
The WP_Query instance (passed by reference).

More Information

parse_query is an action triggered after WP_Query::parse_query() has set up query variables (such as the various is_ variables used for conditional tags).

Source

do_action_ref_array( 'parse_query', array( &$this ) );

Changelog

Version Description
1.5.0 Introduced.

User Contributed Notes