register_sidebar_widget

函数
register_sidebar_widget ( $name, $output_callback, $classname = '', $params )
参数
  • (string|int) $name Widget ID.
    Required:
  • (callable) $output_callback Run when widget is called.
    Required:
  • (string) $classname Optional. Classname widget option. Default empty.
    Required:
    Default: (empty)
  • (mixed) $params Widget parameters.
    Required:
相关
  • wp_register_sidebar_widget()
定义位置
相关方法
unregister_sidebar_widgetwp_register_sidebar_widgetwp_unregister_sidebar_widgetregister_sidebarregister_sidebars
引入
2.2.0
弃用
2.8.0

register_sidebar_widget: 这个函数用来注册一个小工具,以便在侧边栏中显示。小工具是小型的插件,可以用来给WordPress网站添加额外的功能,比如社交媒体反馈或通讯注册表。

为侧边栏注册小工具,具有向后兼容性。

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

在参数列表和向后兼容完成后传递给wp_register_sidebar_widget()。

function register_sidebar_widget($name, $output_callback, $classname = '', ...$params) {
	_deprecated_function( __FUNCTION__, '2.8.0', 'wp_register_sidebar_widget()' );
	// 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( $classname ) && is_string( $classname ) ) {
		$options['classname'] = $classname;
	}

	wp_register_sidebar_widget( $id, $name, $output_callback, $options, ...$params );
}

常见问题

FAQs
查看更多 >