WP_Customize_Widgets::start_dynamic_sidebar() – Method

WP_Customize_Widgets::start_dynamic_sidebar( int|string $index )

Begins keeping track of the current sidebar being rendered.

Description

Insert marker before widgets are rendered in a dynamic sidebar.

Parameters

$indexint|stringrequired: Index, name, or ID of the dynamic sidebar.

Source

public function start_dynamic_sidebar( $index ) {
	array_unshift( $this->current_dynamic_sidebar_id_stack, $index );
	if ( ! isset( $this->sidebar_instance_count[ $index ] ) ) {
		$this->sidebar_instance_count[ $index ] = 0;
	}
	$this->sidebar_instance_count[ $index ] += 1;
	if ( ! $this->manager->selective_refresh->is_render_partials_request() ) {
		printf( "\n<!--dynamic_sidebar_before:%s:%d-->\n", esc_html( $index ), (int) $this->sidebar_instance_count[ $index ] );
	}
}

View all references View on Trac View on GitHub

Uses	Description
esc_html()`wp-includes/formatting.php`	Escaping for HTML blocks.

Changelog

Version	Description
4.5.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.