do_action_deprecated

The timeline below displays how wordpress function do_action_deprecated has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 5.8

/**
 * 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.
 *
 * @since 4.6.0
 *
 * @see _deprecated_hook()
 *
 * @param string $hook_name   The name of the action hook.
 * @param array  $args        Array of additional function arguments to be passed to do_action().
 * @param string $version     The version of WordPress that deprecated the hook.
 * @param string $replacement Optional. The hook that should have been used. Default empty.
 * @param string $message     Optional. A message regarding the change. Default empty.
 */
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);
}

WordPress Version: 5.5

/**
 * 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.
 *
 * @since 4.6.0
 *
 * @see _deprecated_hook()
 *
 * @param string $tag         The name of the action hook.
 * @param array  $args        Array of additional function arguments to be passed to do_action().
 * @param string $version     The version of WordPress that deprecated the hook.
 * @param string $replacement Optional. The hook that should have been used. Default empty.
 * @param string $message     Optional. A message regarding the change. Default empty.
 */
function do_action_deprecated($tag, $args, $version, $replacement = '', $message = '')
{
    if (!has_action($tag)) {
        return;
    }
    _deprecated_hook($tag, $version, $replacement, $message);
    do_action_ref_array($tag, $args);
}

WordPress Version: 5.4

/**
 * 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.
 *
 * @since 4.6.0
 *
 * @see _deprecated_hook()
 *
 * @param string $tag         The name of the action hook.
 * @param array  $args        Array of additional function arguments to be passed to do_action().
 * @param string $version     The version of WordPress that deprecated the hook.
 * @param string $replacement Optional. The hook that should have been used. Default null.
 * @param string $message     Optional. A message regarding the change. Default null.
 */
function do_action_deprecated($tag, $args, $version, $replacement = null, $message = null)
{
    if (!has_action($tag)) {
        return;
    }
    _deprecated_hook($tag, $version, $replacement, $message);
    do_action_ref_array($tag, $args);
}

WordPress Version: 4.6

/**
 * 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.
 *
 * @since 4.6.0
 *
 * @see _deprecated_hook()
 *
 * @param string $tag         The name of the action hook.
 * @param array  $args        Array of additional function arguments to be passed to do_action().
 * @param string $version     The version of WordPress that deprecated the hook.
 * @param string $replacement Optional. The hook that should have been used.
 * @param string $message     Optional. A message regarding the change.
 */
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);
}