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

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

「関数リファレンス/get sidebar」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(Function Reference/get sidebar|92909}}<!-- 23:15, 11 September 2010 Ramiy 版)
 
()
 
(4人の利用者による、間の4版が非表示)
1行目: 1行目:
==Description==
+
==説明==
[[Include Tags|Includes]] the <tt>sidebar.php</tt> template file from your current theme's directory. If a name ($name) is specified then a specialized sidebar <tt>sidebar-{name}.php</tt> will be included.
+
現在のテーマディレクトリの <tt>sidebar.php</tt> テンプレートファイルを[[インクルードタグ|読み込みます]]。
  
If the theme contains no <tt>sidebar.php</tt> file then the sidebar from the default theme <code>wp-includes/theme-compat/sidebar.php</code> will be included.
+
名前 ($name) を指定すると、対応するサイドバー <tt>sidebar-{name}.php</tt> を読み込みます。<tt>sidebar-{name}.php</tt> が存在しない場合は、かわりに <tt>sidebar.php</tt> を読み込みます。
  
==Usage==
+
<tt>sidebar.php</tt> ファイルがテーマに含まれていない場合は、デフォルトテーマの <code>wp-includes/theme-compat/sidebar.php</code> からサイドバーを読み込みます。
%%%<?php get_sidebar( $name ); ?>%%%
+
  
==Parameters==
+
==使い方==
{{Parameter|$name|string|Calls for <tt>sidebar-name.php</tt>.|optional}}
+
<?php get_sidebar( $name ); ?>
  
==Examples==
+
==パラメータ==
 +
{{Parameter|$name|文字列|<tt>sidebar-name.php</tt> を読み込む|オプション}}
  
===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 Development|Theme]] as <tt>404.php</tt>).
+
 
 +
===シンプルな 404 ページ===
 +
次のコードは、"HTTP 404: Not Found" エラーページ(お使いの[[テーマの作成|テーマ]]<tt>404.php</tt>)のシンプルな例です。
  
 
<pre>
 
<pre>
22行目: 24行目:
 
</pre>
 
</pre>
  
===Left and Right Sidebars===
+
===左サイドバーと右サイドバー===
Two sidebars in one theme.
+
一つのテーマで二つのサイドバーが使えます。
  
 
<pre>
 
<pre>
32行目: 34行目:
 
</pre>
 
</pre>
  
The file names for the right and left sidebars should be <tt>sidebar-right.php</tt> and <tt>sidebar-left.php</tt> respectively.
+
この場合、右サイドバーと左サイドバーのファイル名は、それぞれ <tt>sidebar-right.php</tt> <tt>sidebar-left.php</tt> にします。
  
===Multi sidebars===
+
===複数のサイドバー===
Different sidebar for different pages.
+
ページごとに異なるサイドバーを読み込みます。
  
 
<pre>
 
<pre>
49行目: 51行目:
 
</pre>
 
</pre>
  
The file names for the home and 404 sidebars should be <tt>sidebar-home.php</tt> and <tt>sidebar-404.php</tt> respectively.
+
この場合、ホームのサイドバーと 404 のサイドバーは、それぞれ <tt>sidebar-home.php</tt> <tt>sidebar-404.php</tt> にします。
  
==Notes==
+
====
  
* Uses: [[Function_Reference/locate_template|locate_template()]]
+
* Uses: [[関数リファレンス/locate_template|locate_template()]] /[[:en:Function_Reference/locate_template|en]]  
* Uses: [[Function_Reference/do_action|do_action()]] Calls 'get_sidebar' action.
+
* Uses: [[関数リファレンス/do_action|do_action()]] Calls 'get_sidebar' action.
  
==Change Log==
+
==変更履歴==
* Since: [[Version 1.5|1.5.0]]
+
* [[Version 1.5|1.5.0]] 以降
* [[Version 2.5|2.5.0]] : Added the '<code>name</code>' parameters.
+
* [[Version 2.5|2.5.0]] '<code>name</code>' パラメータを追加。
  
==Source File==
+
==ソースファイル==
<tt>get_sidebar()</tt> is located in {{Trac|wp-includes/general-template.php}}.
+
<tt>get_sidebar()</tt> は、{{Trac|wp-includes/general-template.php}} にあります。
  
==Related==
+
==関連==
{{インクルードタグ}}
+
{{Include Tags}}
 
{{Tag Footer}}
 
{{Tag Footer}}
  
 
[[Category:関数]]
 
[[Category:関数]]
{{原文|Function Reference/get sidebar|92909}}<!-- 23:15, 11 September 2010 Ramiy  版 -->
+
{{原文|Function Reference/get sidebar|92909}}<!-- 23:56, 28 May 2013 Especkman 版 -->

2015年6月14日 (日) 14:02時点における最新版

説明

現在のテーマディレクトリの sidebar.php テンプレートファイルを読み込みます

名前 ($name) を指定すると、対応するサイドバー sidebar-{name}.php を読み込みます。sidebar-{name}.php が存在しない場合は、かわりに sidebar.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最新版との差分