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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
18行目: 18行目:
 
== 返り値 ==
 
== 返り値 ==
  
; (boolean) : True, if widget sidebar was found and called. False if not found or not called.
+
; (boolean) : サイドバーの中にウィジェットが登録されているときは True を、ウィジェットが登録されていない、サイドバーが見つからない時は False を返します。
  
 
==サンプル==
 
==サンプル==
35行目: 35行目:
 
==複数のサイドバー==
 
==複数のサイドバー==
  
You can load a specific sidebar by either their name (if given a string) or ID (if given an integer). For example, <tt>dynamic_sidebar('top_menu')</tt> will present a sidebar registered with <tt>register_sidebar(array('name'=>'top_menu',))</tt>.
+
=== 複数のサイドバーの登録 ===
 +
 
 +
register_sidebars( $count, $args );
 +
 
 +
利用中のテーマで使用する 1 つ以上のサイドバーを登録します。ほとんどのテーマはサイドバーが 1 つあります。このため、サイドバー数パラメータはオプションで、デフォルト値は 1 です。
 +
 
 +
$args パラメータは、[[関数リファレンス/register_sidebar|register_sidebar()]] に渡され、そのフォーマットに準じます。ただし名前は、サイドバーが複数の場合、sprintf() で処理して一意の番号を挿入または付加します。
 +
 
 +
例えば、次の行は、"Foobar 1" と "Foobar 2" というサイドバーを作成します。
 +
 
 +
register_sidebars(2, array('name'=>'Foobar %d'));
  
Using ID's ( <tt>dynamic_sidebar(1)</tt> ) is easier in that you don't need to name your sidebar, but they are harder to figure out which is which without looking into your <tt>functions.php</tt> file or in the widgets administration panel and thus make your code less readable. Note that ID's begin at 1.
 
  
 
== 変更履歴 ==
 
== 変更履歴 ==
53行目: 62行目:
 
{{原文|Function Reference/dynamic_sidebar|78546}}<!-- 11:17, 28 September 2009 Ramiy 版 -->
 
{{原文|Function Reference/dynamic_sidebar|78546}}<!-- 11:17, 28 September 2009 Ramiy 版 -->
  
== 関連 ==
+
== 関連資料 ==
  
 
{{Widget Tags}}
 
{{Widget Tags}}

2014年11月26日 (水) 21:48時点における版

このページ「関数リファレンス/dynamic sidebar」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

説明

この関数はアクティブなウィジェットコールバック関数を順に呼び出し、サイドバーに表示します。複数のサイドバーがある場合、表示するサイドバーの番号または名前を知らせる必要があります。この関数が正しく実行されると true を返し、失敗すると false を返します。

静的なサイドバーを表示するかどうかを決定するのに、返り値を使用すべきです。こうすることで、ウィジェットプラグインがアクティブでない場合にも、テーマがきちんと表示されるようにできます。

サイドバーを番号で登録している場合、番号で呼び出します。名前で登録している場合は、名前で呼び出します。

使い方

<?php dynamic_sidebar( $number ); ?>

パラメーター

$number
int/string) (optional名称、またはサイドバーのID
初期値: 1

返り値

(boolean) 
サイドバーの中にウィジェットが登録されているときは True を、ウィジェットが登録されていない、サイドバーが見つからない時は False を返します。

サンプル

致命的なエラーを防ぐために、以下のように使用することをお勧めします。

<ul id="sidebar">
<?php if ( !function_exists('dynamic_sidebar') || !dynamic_sidebar() ) : ?>
<li>{static sidebar item 1}</li>
<li>{static sidebar item 2}</li>
<?php endif; ?>
</ul>

複数のサイドバー

複数のサイドバーの登録

register_sidebars( $count, $args );

利用中のテーマで使用する 1 つ以上のサイドバーを登録します。ほとんどのテーマはサイドバーが 1 つあります。このため、サイドバー数パラメータはオプションで、デフォルト値は 1 です。

$args パラメータは、register_sidebar() に渡され、そのフォーマットに準じます。ただし名前は、サイドバーが複数の場合、sprintf() で処理して一意の番号を挿入または付加します。

例えば、次の行は、"Foobar 1" と "Foobar 2" というサイドバーを作成します。

register_sidebars(2, array('name'=>'Foobar %d'));


変更履歴

Since: 2.2.0

ソースファイル

dynamic_sidebar()wp-includes/widgets.php にあります。

合わせて読みたい記事

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

関連資料

ウィジェット API: is_active_widget(), the_widget(), register_widget(), unregister_widget() / en, wp_register_widget_control() / en, wp_unregister_widget_control() / en, wp_convert_widget_settings() / en, wp_get_widget_defaults() / en, wp_widget_description() / en



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

最新英語版 :