- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
テンプレートタグ/wp dropdown categories
提供: WordPress Codex 日本語版
< テンプレートタグ
この記事は翻訳時に編集が必要であるとマークされていました。その為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()