钩子文档

query_string

💡 云策文档标注

概述

query_string 是一个已弃用的 WordPress Hook,用于在解析查询字符串前进行过滤。自 2.1.0 版本起,建议改用 'query_vars' 或 'request' 过滤器。

关键要点

  • query_string Hook 接受一个字符串参数 $query_string,用于修改查询字符串。
  • 该 Hook 在 WordPress 2.1.0 版本中被弃用,推荐使用 'query_vars' 或 'request' 过滤器替代。
  • 相关函数 WP::build_query_string() 用于基于查询变量属性设置查询字符串属性。

代码示例

$this->query_string = apply_filters_deprecated(
    'query_string',
    array( $this->query_string ),
    '2.1.0',
    'query_vars, request'
);

注意事项

  • query_string Hook 自 2.1.0 版本起已弃用,开发者应避免在新代码中使用,并考虑迁移到 'query_vars' 或 'request' 过滤器。
  • 该 Hook 在 WordPress 1.5.0 版本中引入,2.1.0 版本弃用,历史代码中可能仍存在相关用法。

📄 原文内容

Filters the query string before parsing.

Parameters

$query_stringstring
The query string to modify.

Source

$this->query_string = apply_filters_deprecated(
	'query_string',
	array( $this->query_string ),
	'2.1.0',
	'query_vars, request'
);

Changelog

Version Description
2.1.0 Deprecated. Use ‘query_vars’ or ‘request’ filters instead.
1.5.0 Introduced.