register_widget_control

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

WordPress Version: 5.4

/**
 * Registers widget control callback for customizing options.
 *
 * Allows $name to be an array that accepts either three elements to grab the
 * first element and the third for the name or just uses the first element of
 * the array for the name.
 *
 * Passes to wp_register_widget_control() after the argument list has
 * been compiled.
 *
 * @since 2.2.0
 * @deprecated 2.8.0 Use wp_register_widget_control()
 * @see wp_register_widget_control()
 *
 * @param int|string $name             Sidebar ID.
 * @param callable   $control_callback Widget control callback to display and process form.
 * @param int        $width            Widget width.
 * @param int        $height           Widget height.
 * @param mixed      ...$params        Widget parameters.
 */
function register_widget_control($name, $control_callback, $width = '', $height = '', ...$params)
{
    _deprecated_function(__FUNCTION__, '2.8.0', 'wp_register_widget_control()');
    // Compat.
    if (is_array($name)) {
        if (count($name) === 3) {
            $name = sprintf($name[0], $name[2]);
        } else {
            $name = $name[0];
        }
    }
    $id = sanitize_title($name);
    $options = array();
    if (!empty($width)) {
        $options['width'] = $width;
    }
    if (!empty($height)) {
        $options['height'] = $height;
    }
    wp_register_widget_control($id, $name, $control_callback, $options, ...$params);
}

WordPress Version: 5.3

/**
 * Registers widget control callback for customizing options.
 *
 * Allows $name to be an array that accepts either three elements to grab the
 * first element and the third for the name or just uses the first element of
 * the array for the name.
 *
 * Passes to wp_register_widget_control() after the argument list has
 * been compiled.
 *
 * @since 2.2.0
 * @deprecated 2.8.0 Use wp_register_widget_control()
 * @see wp_register_widget_control()
 *
 * @param int|string $name             Sidebar ID.
 * @param callable   $control_callback Widget control callback to display and process form.
 * @param int        $width            Widget width.
 * @param int        $height           Widget height.
 * @param mixed      ...$params        Widget parameters.
 */
function register_widget_control($name, $control_callback, $width = '', $height = '', ...$params)
{
    _deprecated_function(__FUNCTION__, '2.8.0', 'wp_register_widget_control()');
    // Compat
    if (is_array($name)) {
        if (count($name) === 3) {
            $name = sprintf($name[0], $name[2]);
        } else {
            $name = $name[0];
        }
    }
    $id = sanitize_title($name);
    $options = array();
    if (!empty($width)) {
        $options['width'] = $width;
    }
    if (!empty($height)) {
        $options['height'] = $height;
    }
    wp_register_widget_control($id, $name, $control_callback, $options, ...$params);
}

WordPress Version: 4.6

/**
 * Registers widget control callback for customizing options.
 *
 * Allows $name to be an array that accepts either three elements to grab the
 * first element and the third for the name or just uses the first element of
 * the array for the name.
 *
 * Passes to wp_register_widget_control() after the argument list has
 * been compiled.
 *
 * @since 2.2.0
 * @deprecated 2.8.0 Use wp_register_widget_control()
 * @see wp_register_widget_control()
 *
 * @param int|string $name Sidebar ID.
 * @param callable $control_callback Widget control callback to display and process form.
 * @param int $width Widget width.
 * @param int $height Widget height.
 */
function register_widget_control($name, $control_callback, $width = '', $height = '')
{
    _deprecated_function(__FUNCTION__, '2.8.0', 'wp_register_widget_control()');
    // Compat
    if (is_array($name)) {
        if (count($name) == 3) {
            $name = sprintf($name[0], $name[2]);
        } else {
            $name = $name[0];
        }
    }
    $id = sanitize_title($name);
    $options = array();
    if (!empty($width)) {
        $options['width'] = $width;
    }
    if (!empty($height)) {
        $options['height'] = $height;
    }
    $params = array_slice(func_get_args(), 4);
    $args = array($id, $name, $control_callback, $options);
    if (!empty($params)) {
        $args = array_merge($args, $params);
    }
    call_user_func_array('wp_register_widget_control', $args);
}

WordPress Version: 4.4

/**
 * Registers widget control callback for customizing options.
 *
 * Allows $name to be an array that accepts either three elements to grab the
 * first element and the third for the name or just uses the first element of
 * the array for the name.
 *
 * Passes to wp_register_widget_control() after the argument list has
 * been compiled.
 *
 * @since 2.2.0
 * @deprecated 2.8.0 Use wp_register_widget_control()
 * @see wp_register_widget_control()
 *
 * @param int|string $name Sidebar ID.
 * @param callable $control_callback Widget control callback to display and process form.
 * @param int $width Widget width.
 * @param int $height Widget height.
 */
function register_widget_control($name, $control_callback, $width = '', $height = '')
{
    _deprecated_function(__FUNCTION__, '2.8', 'wp_register_widget_control()');
    // Compat
    if (is_array($name)) {
        if (count($name) == 3) {
            $name = sprintf($name[0], $name[2]);
        } else {
            $name = $name[0];
        }
    }
    $id = sanitize_title($name);
    $options = array();
    if (!empty($width)) {
        $options['width'] = $width;
    }
    if (!empty($height)) {
        $options['height'] = $height;
    }
    $params = array_slice(func_get_args(), 4);
    $args = array($id, $name, $control_callback, $options);
    if (!empty($params)) {
        $args = array_merge($args, $params);
    }
    call_user_func_array('wp_register_widget_control', $args);
}

WordPress Version: 3.7

/**
 * Registers widget control callback for customizing options.
 *
 * Allows $name to be an array that accepts either three elements to grab the
 * first element and the third for the name or just uses the first element of
 * the array for the name.
 *
 * Passes to {@link wp_register_widget_control()} after the argument list has
 * been compiled.
 *
 * @since 2.2.0
 * @deprecated 2.8.0
 * @deprecated Use wp_register_widget_control()
 * @see wp_register_widget_control()
 *
 * @param int|string $name Sidebar ID.
 * @param callback $control_callback Widget control callback to display and process form.
 * @param int $width Widget width.
 * @param int $height Widget height.
 */
function register_widget_control($name, $control_callback, $width = '', $height = '')
{
    _deprecated_function(__FUNCTION__, '2.8', 'wp_register_widget_control()');
    // Compat
    if (is_array($name)) {
        if (count($name) == 3) {
            $name = sprintf($name[0], $name[2]);
        } else {
            $name = $name[0];
        }
    }
    $id = sanitize_title($name);
    $options = array();
    if (!empty($width)) {
        $options['width'] = $width;
    }
    if (!empty($height)) {
        $options['height'] = $height;
    }
    $params = array_slice(func_get_args(), 4);
    $args = array($id, $name, $control_callback, $options);
    if (!empty($params)) {
        $args = array_merge($args, $params);
    }
    call_user_func_array('wp_register_widget_control', $args);
}