register_widget_control()

最后更新于:2021-11-27 21:39:33

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

Registers widget control callback for customizing options.

参数

$name

(int|string) (Required) Sidebar ID.

$control_callback

(callable) (Required) Widget control callback to display and process form.

$width

(int) (Optional) Widget width.

Default value: ”

$height

(int) (Optional) Widget height.

Default value: ”

$params

(mixed) (Required) Widget parameters.

源文件

文件: gc-includes/deprecated.php

function register_widget_control($name, $control_callback, $width = '', $height = '', ...$params) {
	_deprecated_function( __FUNCTION__, '2.8.0', 'gc_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;
	}

	gc_register_widget_control( $id, $name, $control_callback, $options, ...$params );
}