do_action_deprecated( string $hook_name, array $args, string $version, string $replacement = '', string $message = '' )

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

$hook_name

(Required) The name of the action hook.

$args

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

$version

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

$replacement

(Optional) The hook that should have been used.

Default value: ''

$message

(Optional) A message regarding the change.

Default value: ''

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

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/plugin.php: has_action()

Checks if any action has been registered for a hook.
wp-includes/plugin.php: do_action_ref_array()

Calls the callback functions that have been added to an action hook, specifying arguments in an array.
wp-includes/functions.php: _deprecated_hook()

Marks a deprecated action or filter hook as deprecated and throws a notice.

Used By

Used By
Used By Description
wp-admin/includes/meta-boxes.php: register_and_do_post_meta_boxes()

Registers the default post meta boxes, and runs the do_meta_boxes actions.
wp-includes/comment.php: wp_check_comment_disallowed_list()

Checks if a comment contains disallowed characters or words.
wp-includes/ms-site.php: wp_insert_site()

Inserts a new site into the database.
wp-includes/ms-site.php: wp_delete_site()

Deletes a site from the database.
wp-includes/ms-site.php: clean_blog_cache()

Clean the blog cache
wp-includes/user.php: get_password_reset_key()

Creates, stores, then returns a password reset key for user.
wp-includes/post.php: _transition_post_status()

Hook for managing future post transitions to published.
wp-admin/includes/ms.php: wpmu_delete_blog()

Deletes a site.
Show 3 more used by Hide more used by

Changelog

Changelog
Version Description
4.6.0 Introduced.