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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(関連資料: {{Sidebar Tags}})
(原文タグの更新)
51行目: 51行目:
 
* [http://www.prelovac.com/vladimir/wordpress-theme-flexibility-with-dynamic-sidebars WordPress theme flexibility with dynamic sidebars]
 
* [http://www.prelovac.com/vladimir/wordpress-theme-flexibility-with-dynamic-sidebars WordPress theme flexibility with dynamic sidebars]
  
{{原文|Function Reference/dynamic_sidebar|78546}}<!-- 11:17, 28 September 2009 Ramiy 版 -->
+
 
  
 
== 関連資料 ==
 
== 関連資料 ==
65行目: 65行目:
 
[[Category:wp2.2]]
 
[[Category:wp2.2]]
  
最新英語版 : [[en:Function Reference/dynamic_sidebar]]
+
{{原文|Function Reference/dynamic_sidebar|148139}}<!-- 13:08, 26 November 2014‎ Ishihara takashi 版 -->

2015年6月16日 (火) 10:17時点における版

説明

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

複数のサイドバー

名称 ( idを文字列で指定した場合 )、または ID (整数値で指定、または指定しなかった場合)のいずれかで特定のサイドバーをロードすることができます。 例として、 register_sidebar(array('name'=>'top_menu',)) という定義でサイドバーを登録している場合、dynamic_sidebar('top_menu')という記述で呼び出すことができます。

IDを使って呼び出す場合、 ( dynamic_sidebar(1) ) あなたはサイドバーの名称を必要としませんが、これはdynamic_sidebar関数でサイドバーを呼び出す際に把握しにくくなります。IDは1から始まることに注意してください。

変更履歴

Since: 2.2.0

ソースファイル

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

合わせて読みたい記事


関連資料

サイドバー: is_active_sidebar(), is_dynamic_sidebar(), dynamic_sidebar(), register_sidebars(), register_sidebar(), unregister_sidebar(), wp_register_sidebar_widget() / en, wp_unregister_sidebar_widget() / en, wp_get_sidebars_widgets() / en, wp_set_sidebars_widgets() / en,



ウィジェット 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



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

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