do_action_deprecated

函数


do_action_deprecated ( $hook_name, $args, $version, $replacement = '', $message = '' )
参数
  • (string)
    $hook_name
    The name of the action hook.
    Required:
  • (array)
    $args
    Array of additional function arguments to be passed to do_action().
    Required:
  • (string)
    $version
    The version of WordPress that deprecated the hook.
    Required:
  • (string)
    $replacement
    Optional. The hook that should have been used. Default empty.
    Required:
    Default: (empty)
  • (string)
    $message
    Optional. A message regarding the change. Default empty.
    Required:
    Default: (empty)
相关
  • _deprecated_hook()
定义位置
  • wp-includes/plugin.php
    , line 738
引入
4.6.0
弃用

Fires functions attached to a deprecated action hook.

When an action hook is deprecated, the do_action() call is replaced with
do_action_deprecated(), which triggers a deprecation notice and then fires
the original hook.

function do_action_deprecated( $hook_name, $args, $version, $replacement = '', $message = '' ) {
	if ( ! has_action( $hook_name ) ) {
		return;
	}

	_deprecated_hook( $hook_name, $version, $replacement, $message );

	do_action_ref_array( $hook_name, $args );
}