• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

関数リファレンス/get sidebar

提供: WordPress Codex 日本語版
< 関数リファレンス
2013年1月16日 (水) 10:25時点におけるGatespace (トーク | 投稿記録)による版 (関連: インクルードタグのリンク修正)

移動先: 案内検索

説明

現在のテーマディレクトリの sidebar.php テンプレートファイルを読み込みます。名前 ($name) を指定すると、指定したサイドバー sidebar-{name}.php を読み込みます。

sidebar.php ファイルがテーマに含まれていない場合は、デフォルトテーマの wp-includes/theme-compat/sidebar.php を読み込みます。

使い方

<?php get_sidebar( $name ); ?>

パラメータ

$name
文字列) (オプションsidebar-name.php を読み込む
初期値: なし

用例

シンプルな 404 ページ

次のコードは、"HTTP 404: Not Found" エラーページ(お使いのテーマ404.php)のシンプルな例です。

<?php get_header(); ?>
<h2>Error 404 - Not Found</h2>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

左サイドバーと右サイドバー

一つのテーマで二つのサイドバーが使えます。

<?php get_header(); ?>
<?php get_sidebar('left'); ?>
<?php get_sidebar('right'); ?>
<?php get_footer(); ?>

右サイドバーと左サイドバーのファイル名は、それぞれ sidebar-right.phpsidebar-left.php にしてください。

複数のサイドバー

異なるページで異なるサイドバーを読み込みます。

<?php
if ( is_home() ) :
    get_sidebar('home');
elseif ( is_404() ) :
    get_sidebar('404');
else :
    get_sidebar();
endif;
?>

ホームのサイドバーと 404 のサイドバーは、それぞれ sidebar-home.phpsidebar-404.php にしてください。

変更履歴

  • 1.5.0 以降
  • 2.5.0 で 'name' パラメータを追加。

ソースファイル

get_sidebar() は、wp-includes/general-template.php にあります。

関連

インクルードタグ: get_header(), get_footer(), get_sidebar(), get_template_part(), get_search_form(), comments_template()


関数リファレンステンプレートタグ目次もご覧ください。

最新英語版: WordPress Codex » Function Reference/get sidebar最新版との差分