当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(Function Reference/get sidebar|92909}}<!-- 23:15, 11 September 2010 Ramiy 版)
 
(翻訳済。divなし)
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> テンプレートファイルを[[インクルードタグ|読み込みます]]。名前 ($name) を指定すると、指定したサイドバー <tt>sidebar-{name}.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.
+
<tt>sidebar.php</tt> ファイルがテーマに含まれていない場合は、デフォルトテーマの <code>wp-includes/theme-compat/sidebar.php</code> を読み込みます。
  
==Usage==
+
==使い方==
%%%<?php get_sidebar( $name ); ?>%%%
+
<?php get_sidebar( $name ); ?>
  
==Parameters==
+
==パラメータ==
{{Parameter|$name|string|Calls for <tt>sidebar-name.php</tt>.|optional}}
+
{{Parameter|$name|文字列|<tt>sidebar-name.php</tt> を世澪込む|オプション}}
  
==Examples==
+
==用例==
  
===Simple 404 page===
+
===シンプルな 404 ページ===
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>).
+
次のコードは、"HTTP 404: Not Found" エラーページ(お使いの[[テーマの作成|テーマ]]<tt>404.php</tt>)のシンプルな例です。
  
 
<pre>
 
<pre>
22行目: 22行目:
 
</pre>
 
</pre>
  
===Left and Right Sidebars===
+
===左サイドバーと右サイドバー===
Two sidebars in one theme.
+
一つのテーマで二つのサイドバーが使えます。
  
 
<pre>
 
<pre>
32行目: 32行目:
 
</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行目: 49行目:
 
</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()]]
* 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==
+
==関連==
 
{{インクルードタグ}}
 
{{インクルードタグ}}
 
{{Tag Footer}}
 
{{Tag Footer}}

2011年1月17日 (月) 15:45時点における版

説明

現在のテーマディレクトリの 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 にあります。

関連

テンプレート:インクルードタグ

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

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