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.
See also
Parameters
- $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 ClassicPress or 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
Source
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 );
}
Changelog
| Version | Description |
|---|---|
| WP-4.6.0 | Introduced. |