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

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

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

提供: WordPress Codex 日本語版
< テンプレートタグ
2007年7月20日 (金) 22:03時点におけるBono (トーク | 投稿記録)による版 (en:Template Tags/wp_dropdown_categories 13:07, 31 May 2007 MichaelH 版)

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索
この記事は翻訳時に編集が必要であるとマークされていました。その為Codex原文が大きく編集されている可能性があります。内容を確認される際は原文を参照していただき、可能であれば本項目へ反映させてください。よりよいCodexを作成するためのお手伝いをお願いします。

原文・最新版: WordPress Codex » wp_dropdown_categories

Description

Displays a list of categories in a select (i.e dropdown) box with no submit button.

Usage

%%% <?php wp_dropdown_categories('arguments'); ?> %%%

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');

By default, the usage shows:

  • Sorts by category id in ascending order
  • Does not show the last date updated
  • Does not show the count of posts within a category
  • Does not show 'empty' categories
  • Excludes nothing
  • Displays (echos) the categories
  • No category is 'selected' in the form
  • Does not display the categories in a hierarchical structure
  • Assigns 'cat' to the form name
  • Assigns the form to the class 'postform'
<?php wp_dropdown_categories(); ?>

Dropdown with Submit Button

Displays a hierarchical category dropdown list in HTML form with a submit button, in a WordPress sidebar unordered list, with a count of posts in each category.

<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 
(string) Causes the HTML for the dropdown to allow you to select All of the categories.
show_option_none 
(string) Causes the HTML for the dropdown to allow you to select NONE of the categories.
orderby 
(string) Key to sort options by. Valid values:
  • 'ID' (Default)
  • 'name'
order 
(string) Sort order for options. Valid values:
  • 'ASC' (Default)
  • 'DESC'
show_last_update 
(boolean) Sets whether to display the date of the last post in each category. Valid values:
  • 1 (True)
  • 0 (False - Default)
show_count 
(boolean) Sets whether to display a count of posts in each category. Valid values:
  • 1 (True)
  • 0 (False - Default)
hide_empty 
(boolean) Sets whether to hide (not display) categories with no posts. Valid values:
  • 1 (True - Default)
  • 0 (False)
child_of 
(integer) Only display categories that are children of the category identified by its ID. There is no default for this parameter.
exclude 
(string) Comma separated list of category IDs to exclude. For example, 'exclude=4,12' means category IDs 4 and 12 will NOT be displayed/echoed or returned. Defaults to exclude nothing.
echo 
(boolean) Display bookmarks (TRUE) or return them for use by PHP (FALSE). Defaults to TRUE.
  • 1 (True - default)
  • 0 (False)
selected 
(integer) Category ID of the category to be 'selected' or presented in the display box. Defaults to no category selected.
hierarchical 
(boolean) Display categories in hierarchical fashion (child categories show indented). Defaults to FALSE.
  • 1 (True)
  • 0 (False - Default)
name 
(string) Name assigned to the dropdown form. Defaults to 'cat'.
class 
(string) Class assinged to the dropdown form. Defaults to '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 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。