_register_widget_update_callback

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

WordPress Version: 6.5

/**
 * Registers the update callback for a widget.
 *
 * @since 2.8.0
 * @since 5.3.0 Formalized the existing and already documented `...$params` parameter
 *              by adding it to the function signature.
 *
 * @global array $wp_registered_widget_updates The registered widget updates.
 *
 * @param string   $id_base         The base ID of a widget created by extending WP_Widget.
 * @param callable $update_callback Update callback method for the widget.
 * @param array    $options         Optional. Widget control options. See wp_register_widget_control().
 *                                  Default empty array.
 * @param mixed    ...$params       Optional additional parameters to pass to the callback function when it's called.
 */
function _register_widget_update_callback($id_base, $update_callback, $options = array(), ...$params)
{
    global $wp_registered_widget_updates;
    if (isset($wp_registered_widget_updates[$id_base])) {
        if (empty($update_callback)) {
            unset($wp_registered_widget_updates[$id_base]);
        }
        return;
    }
    $widget = array('callback' => $update_callback, 'params' => $params);
    $widget = array_merge($widget, $options);
    $wp_registered_widget_updates[$id_base] = $widget;
}

WordPress Version: 5.3

/**
 * Registers the update callback for a widget.
 *
 * @since 2.8.0
 * @since 5.3.0 Formalized the existing and already documented `...$params` parameter
 *              by adding it to the function signature.
 *
 * @global array $wp_registered_widget_updates
 *
 * @param string   $id_base         The base ID of a widget created by extending WP_Widget.
 * @param callable $update_callback Update callback method for the widget.
 * @param array    $options         Optional. Widget control options. See wp_register_widget_control().
 *                                  Default empty array.
 * @param mixed    ...$params       Optional additional parameters to pass to the callback function when it's called.
 */
function _register_widget_update_callback($id_base, $update_callback, $options = array(), ...$params)
{
    global $wp_registered_widget_updates;
    if (isset($wp_registered_widget_updates[$id_base])) {
        if (empty($update_callback)) {
            unset($wp_registered_widget_updates[$id_base]);
        }
        return;
    }
    $widget = array('callback' => $update_callback, 'params' => $params);
    $widget = array_merge($widget, $options);
    $wp_registered_widget_updates[$id_base] = $widget;
}

WordPress Version: 4.6

/**
 * Registers the update callback for a widget.
 *
 * @since 2.8.0
 *
 * @global array $wp_registered_widget_updates
 *
 * @param string   $id_base         The base ID of a widget created by extending WP_Widget.
 * @param callable $update_callback Update callback method for the widget.
 * @param array    $options         Optional. Widget control options. See wp_register_widget_control().
 *                                  Default empty array.
 */
function _register_widget_update_callback($id_base, $update_callback, $options = array())
{
    global $wp_registered_widget_updates;
    if (isset($wp_registered_widget_updates[$id_base])) {
        if (empty($update_callback)) {
            unset($wp_registered_widget_updates[$id_base]);
        }
        return;
    }
    $widget = array('callback' => $update_callback, 'params' => array_slice(func_get_args(), 3));
    $widget = array_merge($widget, $options);
    $wp_registered_widget_updates[$id_base] = $widget;
}

WordPress Version: 4.5

/**
 * Registers the update callback for a widget.
 *
 * @since 2.8.0
 *
 * @global array $wp_registered_widget_updates
 *
 * @param string   $id_base         The base ID of a widget created by extending WP_Widget.
 * @param callable $update_callback Update callback method for the widget.
 * @param array    $options         Optional. Widget control options. See {@see wp_register_widget_control()}.
 *                                  Default empty array.
 */
function _register_widget_update_callback($id_base, $update_callback, $options = array())
{
    global $wp_registered_widget_updates;
    if (isset($wp_registered_widget_updates[$id_base])) {
        if (empty($update_callback)) {
            unset($wp_registered_widget_updates[$id_base]);
        }
        return;
    }
    $widget = array('callback' => $update_callback, 'params' => array_slice(func_get_args(), 3));
    $widget = array_merge($widget, $options);
    $wp_registered_widget_updates[$id_base] = $widget;
}

WordPress Version: 4.3

/**
 * @global array $wp_registered_widget_updates
 *
 * @param string   $id_base
 * @param callable $update_callback
 * @param array    $options
 */
function _register_widget_update_callback($id_base, $update_callback, $options = array())
{
    global $wp_registered_widget_updates;
    if (isset($wp_registered_widget_updates[$id_base])) {
        if (empty($update_callback)) {
            unset($wp_registered_widget_updates[$id_base]);
        }
        return;
    }
    $widget = array('callback' => $update_callback, 'params' => array_slice(func_get_args(), 3));
    $widget = array_merge($widget, $options);
    $wp_registered_widget_updates[$id_base] = $widget;
}

WordPress Version: 4.1

/**
 *
 * @global array $wp_registered_widget_updates
 * @param string   $id_base
 * @param callable $update_callback
 * @param array    $options
 */
function _register_widget_update_callback($id_base, $update_callback, $options = array())
{
    global $wp_registered_widget_updates;
    if (isset($wp_registered_widget_updates[$id_base])) {
        if (empty($update_callback)) {
            unset($wp_registered_widget_updates[$id_base]);
        }
        return;
    }
    $widget = array('callback' => $update_callback, 'params' => array_slice(func_get_args(), 3));
    $widget = array_merge($widget, $options);
    $wp_registered_widget_updates[$id_base] = $widget;
}

WordPress Version: 3.7

function _register_widget_update_callback($id_base, $update_callback, $options = array())
{
    global $wp_registered_widget_updates;
    if (isset($wp_registered_widget_updates[$id_base])) {
        if (empty($update_callback)) {
            unset($wp_registered_widget_updates[$id_base]);
        }
        return;
    }
    $widget = array('callback' => $update_callback, 'params' => array_slice(func_get_args(), 3));
    $widget = array_merge($widget, $options);
    $wp_registered_widget_updates[$id_base] = $widget;
}