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
檢視更多 >