register_widget_control( int|string $name, callable $control_callback, int $width, int $height, mixed $params )

This function has been deprecated since 2.8.0. Use wp_register_widget_control() instead.

Registers widget control callback for customizing options.

Description

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.

See also

Parameters

$nameint|stringrequired
Sidebar ID.
$control_callbackcallablerequired
Widget control callback to display and process form.
$widthintrequired
Widget width.
$heightintrequired
Widget height.
$paramsmixedrequired
Widget parameters.

Source

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

Changelog

VersionDescription
2.8.0Deprecated. Use wp_register_widget_control()
2.2.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.