do_action_deprecated() │ WP 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.

Returns

null. Nothing (null).

Usage

do_action_deprecated( $hook_name, $args, $version, $replacement, $message );

$hook_name(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)

The hook that should have been used.
Default: ''

$message(string)

A message regarding the change.
Default: ''

Notes

• See: _deprecated_hook()

Changelog

do_action_deprecated() do action deprecated code ^{WP 7.0}

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 );
}