检索侧栏及其窗口小部件实例ID的完整列表。

原型

wp_get_sidebars_widgets( bool $deprecated = true )

描述

如果需要,将升级侧边栏小部件列表。如果需要,还将保存更新列表。

参数

$deprecated (bool) (Optional) 未使用(参数已弃用)。

返回值

(array)  从管理员调用时,将小部件升级到版本3阵列格式。

源文件

路径:wp-includes/widgets.php

<?php
...
function wp_get_sidebars_widgets( $deprecated = true ) {
	if ( $deprecated !== true )
		_deprecated_argument( __FUNCTION__, '2.8.1' );
	global $_wp_sidebars_widgets, $sidebars_widgets;
	// If loading from front page, consult $_wp_sidebars_widgets rather than options
	// to see if wp_convert_widget_settings() has made manipulations in memory.
	if ( !is_admin() ) {
		if ( empty($_wp_sidebars_widgets) )
			$_wp_sidebars_widgets = get_option('sidebars_widgets', array());
		$sidebars_widgets = $_wp_sidebars_widgets;
	} else {
		$sidebars_widgets = get_option('sidebars_widgets', array());
	}
	if ( is_array( $sidebars_widgets ) && isset($sidebars_widgets['array_version']) )
		unset($sidebars_widgets['array_version']);
	/**
	 * Filters the list of sidebars and their widgets.
	 *
	 * @since 2.7.0
	 *
	 * @param array $sidebars_widgets An associative array of sidebars and their widgets.
	 */
	return apply_filters( 'sidebars_widgets', $sidebars_widgets );
}
...
?>

其他

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