Question

do_action_deprecated( string $tag,  array $args,  string $version,  string $replacement = false,  string $message = null )

Fires functions attached to a deprecated action hook.

---

description

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.

---

参数

$tag

(string) (Required) The name of the action hook.

$args

(array) (Required) Array of additional function arguments to be passed to do_action().

$version

(string) (Required) The version of WordPress that deprecated the hook.

$replacement

(string) (Optional) The hook that should have been used.

Default value: false

$message

(string) (Optional) A message regarding the change.

Default value: null

---

源代码

File: wp-includes/plugin.php

function do_action_deprecated( $tag, $args, $version, $replacement = false, $message = null ) {
	if ( ! has_action( $tag ) ) {
		return;
	}

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

	do_action_ref_array( $tag, $args );
}

---

更新日志

Version	description
4.6.0	Introduced.

---

相关函数

Uses

• wp-includes/functions.php: _deprecated_hook()
• wp-includes/plugin.php: has_action()
• wp-includes/plugin.php: do_action_ref_array()

---

User Contributed Notes