現在のテーマディレクトリからsidebar.phpテンプレートファイルをインクルードします。もし、名前($name)が特殊な場合は、特殊なサイドバーとして、sidebar-name.phpがインクルードされるでしょう。
テーマにsidebar.phpファイルがない場合、サイドバーはデフォルトテーマのwp-content/themes/default/sidebar.phpからインクルードされるでしょう。
Includes the sidebar.php template file from your current theme’s directory. If a name ($name) is specified then a specialized sidebar sidebar-name.php will be included. If the theme contains no sidebar.php file then the sidebar from the default theme wp-content/themes/default/sidebar.php will be included.
get_sidebarのテンプレートタグ使用方法
<?php get_sidebar( $name ); ?>
get_sidebarのパラメーター
$name
(string) (optional)sidebar-name.phpを呼び出します。
(string) (optional) Calls for sidebar-name.php.
デフォルト:なし
Default: None
例
シンプルな404ページ
次のコードは、”HTTP 404:Not Found”エラーに対して簡単なテンプレート例です。(これは404.phpとしてテーマにインクルードすることができます)
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).
<?php get_header(); ?> <h2>Error 404 - Not Found</h2> <?php get_sidebar(); ?> <?php get_footer(); ?>
左と右のサイドバー
1つのテーマの中に2つのサイドバー。
Two sidebars in one theme.
<?php get_header(); ?> <?php get_sidebar('left'); ?> <?php get_sidebar('right'); ?> <?php get_footer(); ?>
左右のサイドバーのファイル名は、それぞれsidebar-right.phpとsidebar-left.phpと指定する必要があります。
The file names for the right and left sidebars should be sidebar-right.php and sidebar-left.php respectively.
マルチサイドバー
別のページに別のサイドバー。
Different sidebar for different pages.
<?php if ( is_home() ) : get_sidebar('home'); elseif ( is_404() ) : get_sidebar('404'); else : get_sidebar(); endif; ?>
homeと404のサイドバーに対するファイル名は、それぞれsidebar-home.phpとsidebar-404.phpと指定する必要があります。
The file names for the home and 404 sidebars should be sidebar-home.php and sidebar-404.php respectively.
備考
*名前パラメーターはバージョン2.5から追加されました。
* The name parameter was added in Version 2.5.
変更ログ
Since: 1.5.0
ソースファイル
get_sidebar()は、wp-includes/general-template.phpに位置しています。
get_sidebar() is located in wp-includes/general-template.php.
関連テンプレートタグ
get_header, get_footer, get_sidebar, get_template_part, get_search_form, comments_template
See also index of Function Reference and index of Template Tags.