register_widget_control

函数
register_widget_control ( $name, $control_callback, $width = '', $height = '', $params )
参数
  • (int|string) $name Sidebar ID.
    Required:
  • (callable) $control_callback Widget control callback to display and process form.
    Required:
  • (int) $width Widget width.
    Required:
    Default: (empty)
  • (int) $height Widget height.
    Required:
    Default: (empty)
  • (mixed) $params Widget parameters.
    Required:
相关
  • wp_register_widget_control()
定义位置
相关方法
unregister_widget_controlwp_register_widget_controlwp_unregister_widget_controlwp_render_widget_controlregister_widget
引入
2.2.0
弃用
2.8.0

register_widget_control: 这个函数用来为一个小工具注册一个控制表单: 当用户把小工具添加到侧边栏时,控制表格就会显示出来。它允许用户配置小工具的设置。

注册用于自定义选项的小工具控制回调。

允许$name是一个数组,接受三个元素来抓取第一个元素,第三个元素为名称,或者只使用数组的第一个元素为名称。

在参数列表被编译后传递给wp_register_widget_control()。

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

常见问题

FAQs
查看更多 >