Question

wp_list_widget_controls( string $sidebar,  string $sidebar_name = '' )

Show the widgets and their settings for a sidebar.

---

description

Used in the admin widget config screen.

---

参数

$sidebar

(string) (Required) Sidebar ID.

$sidebar_name

(string) (Optional) Sidebar name.

Default value: ''

---

源代码

File: wp-admin/includes/widgets.php

function wp_list_widget_controls( $sidebar, $sidebar_name = '' ) {
	add_filter( 'dynamic_sidebar_params', 'wp_list_widget_controls_dynamic_sidebar' );

	$description = wp_sidebar_description( $sidebar );

	echo '<div id="' . esc_attr( $sidebar ) . '" class="widgets-sortables">';

	if ( $sidebar_name ) {
		?>
		<div class="sidebar-name">
			<div class="sidebar-name-arrow"><br /></div>
			<h2><?php echo esc_html( $sidebar_name ); ?> <span class="spinner"></span></h2>
		</div>
		<?php
	}

	if ( ! empty( $description ) ) {
		?>
		<div class="sidebar-description">
			<p class="description"><?php echo $description; ?></p>
		</div>
		<?php
	}

	dynamic_sidebar( $sidebar );

	echo '</div>';
}

---

更新日志

Version	description
2.5.0	Introduced.

---

相关函数

Uses

• wp-includes/formatting.php: esc_attr()
• wp-includes/formatting.php: esc_html()
• wp-includes/plugin.php: add_filter()
• wp-includes/widgets.php: dynamic_sidebar()
• wp-includes/widgets.php: wp_sidebar_description()

---

User Contributed Notes