get_sidebar( string $name = null )
Load sidebar template.
Description Description
Includes the sidebar template for a theme or if a name is specified then a specialised sidebar will be included.
For the parameter, if the file is called "sidebar-special.php" then specify "special".
Parameters Parameters
- $name
-
(string) (Optional) The name of the specialised sidebar.
Default value: null
Source Source
File: wp-includes/general-template.php
function get_sidebar( $name = null ) { /** * Fires before the sidebar template file is loaded. * * @since 2.2.0 * @since 2.8.0 $name parameter added. * * @param string|null $name Name of the specific sidebar file to use. null for the default sidebar. */ do_action( 'get_sidebar', $name ); $templates = array(); $name = (string) $name; if ( '' !== $name ) { $templates[] = "sidebar-{$name}.php"; } $templates[] = 'sidebar.php'; locate_template( $templates, true ); }
Expand full source code Collapse full source code View on Trac
Changelog Changelog
Version | Description |
---|---|
1.5.0 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
Simple call
Assume you have file
wp-content/yourTheme/sidebar-nice-bar.php
. The way you can include this sidebar in your page is:Multi sidebars
Different sidebar for different pages.
The file names for the home and 404 sidebars should be
sidebar-home.php
andsidebar-404.php
respectively.Simple 404 page
The following code is a simple example of a template for an “HTTP 404: Not Found” error (which you could include in your Theme as 404.php).
Left and Right Sidebars
Two sidebars in one theme.
The file names for the right and left sidebars should be
sidebar-right.php
and
sidebar-left.php
respectively.