注册侧边栏的小部件,具有向后兼容性。

原型

register_sidebar_widget( string|int $name, callable $output_callback, string $classname = '' )

描述

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

参考:

  • wp_register_sidebar_widget()

参数

$name (string|int) (Required) 小部件ID。

$output_callback (callable) (Required) 调用窗口小部件时运行。

$classname (string) (Optional)  Classname小部件选项。

$params (mixed) (Optional) ,…小部件参数。

源文件

路径:wp-includes/deprecated.php

<?php
...
function register_sidebar_widget($name, $output_callback, $classname = '') {
	_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;
	$params = array_slice(func_get_args(), 2);
	$args = array($id, $name, $output_callback, $options);
	if ( !empty($params) )
		$args = array_merge($args, $params);
	call_user_func_array('wp_register_sidebar_widget', $args);
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/register_sidebar_widget/