wp_get_sidebars_widgets

函数
wp_get_sidebars_widgets ( $deprecated = true )
Access
Private
参数
  • (bool) $deprecated Not used (argument deprecated).
    Required:
    Default: true
返回值
  • (array) Upgraded list of widgets to version 3 array format when called from the admin.
定义位置
相关方法
wp_set_sidebars_widgetswp_map_sidebars_widgetswp_register_sidebar_widgetwp_unregister_sidebar_widgetwp_get_sidebar
引入
2.2.0
弃用
-

wp_get_sidebars_widgets: 这个函数检索当前分配给WordPress站点中每个侧边栏的小工具的列表。它返回一个数组,其中侧边栏的名字是键,小工具的ID列表是值。

检索侧边栏的完整列表和它们的小工具实例ID。

如果需要的话,将升级侧边栏小工具列表。如果需要的话,也会保存更新的列表。

function wp_get_sidebars_widgets( $deprecated = true ) {
	if ( true !== $deprecated ) {
		_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 );
}

常见问题

FAQs
查看更多 >