！ 各ページ右上の画像広告経由でコンピュータウィルスがダウンロードされた可能性があります。ウィルスチェックをお願いします。詳しくは http://bono.s201.xrea.com/2008/06/693-virus_by_xrea_ad/ をご覧ください。ご迷惑をおかけしてしまい大変申し訳ありません。

テンプレートタグ/wp dropdown pages

出典: ps*wiki

目次

説明

送信ボタンのない、ページのリストのセレクトボックス (つまり、ドロップダウン) を表示します。

使い方 

<?php wp_dropdown_pages('arguments'); ?>

用例

初期設定での使用 

$defaults = array('depth' => 0, 'child_of' => 0, 'selected' => 0, 
'echo' => 1,'name' => 'page_id', 'show_option_none' => '');

デフォルトでは以下のように動作します。

  • ページとサブページが親子関係をインデントして表示します
  • すべてのページを表示します (子ページに制限はありません)
  • 「selected」になっているページはなく、初期状態で選択されているページはありません
  • ドロップダウンには「page_id」という name がつけられます
  • 空の値を選択することはできません (show_option_none) 
<?php wp_dropdown_pages(); ?>

送信ボタンのある階層ページのドロップダウンリストを HTML フォームに表示します。 

<li id="pages">
 <h2><?php _e('pages:'); ?></h2>
   <form action="<?php bloginfo('url'); ?>" method="get">
   <?php wp_dropdown_pages(); ?>
   <input type="submit" name="submit" value="view" />
   </form>
</li>

パラメータ

depth 
(整数) このパラメータは wp_list_pages で表示されるリストに含めるページの階層レベルを設定します。デフォルト値は 0 です (すべてのページとサブページを表示します)。
  • 0 - ページとサブページを親子関係を維持して (インデントして) 表示します (デフォルト)
  • -1 - ページとサブページを同列に (インデントなし) 表示します
  • 1 - トップレベルのページのみ表示します
  • 2 - 2 (またはそれ以上) の深さ (レベル) のページを表示します
child_of 
(整数) ページ ID を値としてそのページのサブページを表示します。デフォルト値は 0 です (すべてのページを表示)。
selected 
(整数) 該当する ID のページを「selected」にし、初期状態でそのページが選択された状態になります。デフォルトではどのページも選択されていません。
echo 
(論理値) ページリストを表示するか、PHP で使うために HTML テキストとして返すかを設定します。デフォルト値は 1 (リストを表示) です。
  • 1 (true) - デフォルト
  • 0 (false)
name 
(文字列) ドロップダウンの name を設定します。デフォルトは「page_id」です
show_option_none 
(文字列) ドロップダウンに空の値の項目を表示します
exclude 
(string) リストから除外したいページの ID をコンマで区切ったリストで定義します。例えば、「exclude=4,12」はページ ID が 4 と 12 のページが表示または返されません。デフォルトでは除外されるページはありません。

上記以外のパラメータ

推奨しませんが、 get_pages ファンクションにあるいくつかのパラメータを wp_dropdown_pages でも使うことができます。以下が get_pages のパラメータの初期設定です。 

$defaults = array('child_of' => 0, 'sort_order' => 'ASC', 'sort_column' => 'post_title',
'hierarchical' => 1, 'exclude' => '', 'include' => '', 'meta_key' => '', 'meta_value' => '', 'authors' => '');

bloginfo, bloginfo_rss, get_bloginfo, get_bloginfo_rss, wp_title, get_archives, wp_get_archives, get_calendar, get_posts, wp_list_pages, wp_dropdown_pages, wp_loginout, wp_register, query_posts, rss_enclosure

テンプレートタグへのクエリ文字列型パラメータの渡し方

テンプレートタグ一覧へ


原文・最新版： WordPress Codex » Template Tags/wp_dropdown_pages （最新版との差分）

"http://bono.s206.xrea.com/pswiki/%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88%E3%82%BF%E3%82%B0/wp_dropdown_pages" より作成
MediaWiki
他の言語