钩子文档

deprecated_argument_run

💡 云策文档标注

概述

当调用已弃用的参数时触发此 Hook,用于通知开发者参数已过时并提供相关信息。

关键要点

  • 触发时机:在调用已弃用的参数时执行
  • 参数:$function_name(函数名)、$message(变更消息)、$version(弃用版本)
  • 相关函数:_deprecated_argument() 用于标记参数为弃用状态

代码示例

do_action( 'deprecated_argument_run', $function_name, $message, $version );

注意事项

  • 此 Hook 自 WordPress 3.0.0 版本引入
  • 主要用于调试和兼容性检查,帮助开发者更新代码以避免使用过时参数

📄 原文内容

Fires when a deprecated argument is called.

Parameters

$function_namestring
The function that was called.
$messagestring
A message regarding the change.
$versionstring
The version of WordPress that deprecated the argument used.

Source

do_action( 'deprecated_argument_run', $function_name, $message, $version );

Changelog

Version Description
3.0.0 Introduced.