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

この記事は翻訳時に編集が必要であるとマークされていました。その為Codex原文が大きく編集されている可能性があります。内容を確認される際は原文を参照していただき、可能であれば本項目へ反映させてください。よりよいCodexを作成するためのお手伝いをお願いします。

原文・最新版： WordPress Codex » wp_dropdown_categories

説明

(Description)

送信ボタンのないセレクトボックス（ドロップダウンメニューなど）を使ったカテゴリリストを表示します。

使い方

(Usage)

<?php wp_dropdown_categories('引数'); ?>

用例

(Examples)

デフォルトの使い方

(Default Usage)

$defaults = array('show_option_all' => '', 'show_option_none' => '', 'orderby' => 'ID', 
'order' => 'ASC', 'show_last_update' => 0, 'show_count' => 0, 'hide_empty' => 1, 
'child_of' => 0, 'exclude' => '', 'echo' => 1, 'selected' => 0, 'hierarchical' => 0, 
'name' => 'cat', 'class' => 'postform');

デフォルトでは次のように表示：

• カテゴリID の昇順にソート
• 最終更新日は非表示
• 各カテゴリの投稿数は非表示
• 空の（投稿のない）カテゴリは非表示
• 除外カテゴリなし
• カテゴリを表示（表示するか値として返すか選べるので）
• フォームの 'selected'（初期選択値）とするカテゴリなし
• カテゴリを階層型構造で表示しない
• フォーム名を 'cat' とする
• フォームのクラスを 'postform' とする

<?php wp_dropdown_categories(); ?>

送信ボタン付きドロップダウンメニュー

(Dropdown with Submit Button)

WordPress サイドバーの箇条書きリスト内に、HTMLフォームの送信ボタン付き階層型カテゴリ・ドロップダウンリストを表示、各カテゴリの投稿数も表示。

<li id="categories">
 <h2><?php _e('Categories:'); ?></h2>
   <form action="<?php bloginfo('url'); ?>" method="get">
   <?php wp_dropdown_categories('show_count=1&hierarchical=1'); ?>
   <input type="submit" name="submit" value="view" />
   </form>
</li>

パラメータ

(Parameters)

show_option_all

（文字列） Causes the HTML for the dropdown to allow you to select All of the categories.

show_option_none

（文字列） Causes the HTML for the dropdown to allow you to select NONE of the categories.

orderby

（文字列） ソートキー。有効値：

• 'ID' - カテゴリID（初期値）
• 'name' - カテゴリ名

order

（文字列） ソート順。有効値：

• 'ASC' - 昇順（初期値）
• 'DESC' - 降順

show_last_update

（真偽値） 各カテゴリに属する投稿の最終更新日を表示するかどうか。有効値：

• 1 (True) - 表示
• 0 (False) - 非表示（初期値）

show_count

（真偽値） 各カテゴリに属する投稿数を表示するかどうか。有効値：

• 1 (True) - 表示
• 0 (False) - 非表示（初期値）

hide_empty

（真偽値） 投稿のないカテゴリを隠す（非表示とする）かどうか。

• 1 (True) - 隠す（初期値）
• 0 (False) - 表示

child_of

（整数） 指定した カテゴリID の子カテゴリのみを表示する。初期値なし。

exclude

（文字列） 除外したいカテゴリID をカンマ区切りで指定。例えば、'exclude=4,12' とすれば、カテゴリID 4 と 12 を表示しない／値として返さない。初期値は除外カテゴリなし。

echo

（真偽値） カテゴリリストを表示する（TRUE）か、PHP で使うために値を返す（FALSE）か。初期値は TRUE。

• 1 (True) - 表示（初期値）
• 0 (False) - 値を返す

selected

（整数） 表示ボックスで 'selected' としたいカテゴリID。（これを付けるとドロップダウンメニューなどの選択値の初期値となる。）デフォルトではどれにも付けない。

hierarchical

（真偽値） カテゴリを階層形式で表示（子カテゴリをインデント）するか。初期値は FALSE。

• 1 (True) - 階層形式
• 0 (False) - 親子同レベル（初期値）

name

（文字列） ドロップダウンメニューのフォーム名。デフォルトは 'cat'。

class

（文字列） ドロップダウンフォームのクラス。デフォルトは 'postform'。

関連

(Related)

カテゴリータグ： the_category(), the_category_rss(), single_cat_title(), category_description(), wp_dropdown_categories(), wp_list_categories(), get_the_category(), get_the_category_by_ID(), get_category_by_slug(), get_the_category_list(), get_category_parents(), get_category_link(), is_category(), in_category()

テンプレートタグへの PHP 関数型パラメータの渡し方、関数リファレンス、テンプレートタグ目次もご覧ください。