register_sidebars()

最后更新于：2021-11-27 21:37:50

register_sidebars( int$number=1, array|string$args=array())

Creates multiple sidebars.

参数

$number

(int) (Optional) Number of sidebars to create.

Default value: 1

$args

(array|string) (Optional) Array or string of arguments for building a sidebar.

‘id’
(string) The base string of the unique identifier for each sidebar. If provided, and multiple sidebars are being defined, the ID will have “-2” appended, and so on. Default ‘sidebar-‘ followed by the number the sidebar creation is currently at.
‘name’
(string) The name or title for the sidebars displayed in the admin dashboard. If registering more than one sidebar, include ‘%d’ in the string as a placeholder for the uniquely assigned number for each sidebar. Default ‘Sidebar’ for the first sidebar, otherwise ‘Sidebar %d’.

Default value: array()

源文件

文件: gc-includes/widgets.php

function register_sidebars( $number = 1, $args = array() ) {
	global $gc_registered_sidebars;
	$number = (int) $number;

	if ( is_string( $args ) ) {
		parse_str( $args, $args );
	}

	for ( $i = 1; $i <= $number; $i++ ) {
		$_args = $args;

		if ( $number > 1 ) {
			if ( isset( $args['name'] ) ) {
				$_args['name'] = sprintf( $args['name'], $i );
			} else {
				/* translators: %d: Sidebar number. */
				$_args['name'] = sprintf( __( 'Sidebar %d' ), $i );
			}
		} else {
			$_args['name'] = isset( $args['name'] ) ? $args['name'] : __( 'Sidebar' );
		}

		// Custom specified ID's are suffixed if they exist already.
		// Automatically generated sidebar names need to be suffixed regardless starting at -0.
		if ( isset( $args['id'] ) ) {
			$_args['id'] = $args['id'];
			$n           = 2; // Start at -2 for conflicting custom IDs.
			while ( is_registered_sidebar( $_args['id'] ) ) {
				$_args['id'] = $args['id'] . '-' . $n++;
			}
		} else {
			$n = count( $gc_registered_sidebars );
			do {
				$_args['id'] = 'sidebar-' . ++$n;
			} while ( is_registered_sidebar( $_args['id'] ) );
		}
		register_sidebar( $_args );
	}
}