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

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

「テンプレートタグ/wp dropdown categories」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Template Tags/wp_dropdown_categories 13:07, 31 May 2007 MichaelH 版)
 
(和訳・編集/show_option_all, show_option_none が未訳。)
3行目: 3行目:
 
原文・最新版: [[:en:Template Tags/wp_dropdown_categories|WordPress Codex » wp_dropdown_categories]]
 
原文・最新版: [[:en:Template Tags/wp_dropdown_categories|WordPress Codex » wp_dropdown_categories]]
  
== Description ==
+
== 説明 ==
Displays a list of categories in a select (i.e dropdown) box with no submit button.
+
(Description)
  
== Usage ==
+
送信ボタンのないセレクトボックス(ドロップダウンメニューなど)を使ったカテゴリリストを表示します。
%%% <?php wp_dropdown_categories('arguments'); ?> %%%
+
  
== Examples ==
+
== 使い方 ==
===Default Usage===
+
(Usage)
 +
<?php wp_dropdown_categories('引数'); ?>
 +
 
 +
== 用例 ==
 +
(Examples)
 +
=== デフォルトの使い方 ===
 +
(Default Usage)
 
<pre>
 
<pre>
 
$defaults = array('show_option_all' => '', 'show_option_none' => '', 'orderby' => 'ID',  
 
$defaults = array('show_option_all' => '', 'show_option_none' => '', 'orderby' => 'ID',  
17行目: 22行目:
 
'name' => 'cat', 'class' => 'postform');
 
'name' => 'cat', 'class' => 'postform');
 
</pre>
 
</pre>
By default, the usage shows:
+
デフォルトでは次のように表示:
* Sorts by category id in ascending order
+
* カテゴリID の昇順にソート
* 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
+
* フォームの <code>'selected'</code>(初期選択値)とするカテゴリなし
* Does not display the categories in a hierarchical structure
+
* カテゴリを階層型構造で表示しない
* Assigns 'cat' to the form name
+
* フォーム名を <code>'cat'</code> とする
* Assigns the form to the class 'postform'
+
* フォームのクラスを <code>'postform'</code> とする
  
 
  <?php wp_dropdown_categories(); ?>
 
  <?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.
+
(Dropdown with Submit Button)
  
&lt;li id="categories"&gt;
+
WordPress サイドバーの箇条書きリスト内に、HTMLフォームの送信ボタン付き階層型カテゴリ・ドロップダウンリストを表示、各カテゴリの投稿数も表示。
  &lt;h2&gt;<?php _e('Categories:'); ?>&lt;/h2&gt;
+
 
    &lt;form action="<?php bloginfo('url'); ?>" method="get"&gt;
+
<pre>
    <?php wp_dropdown_categories('show_count=1&hierarchical=1'); ?>
+
<li id="categories">
    &lt;input type="submit" name="submit" value="view" /&gt;
+
<h2><?php _e('Categories:'); ?></h2>
    &lt;/form&gt;
+
  <form action="<?php bloginfo('url'); ?>" method="get">
&lt;/li&gt;
+
  <?php wp_dropdown_categories('show_count=1&hierarchical=1'); ?>
 +
  <input type="submit" name="submit" value="view" />
 +
  </form>
 +
</li>
 +
</pre>
  
== Parameters ==
+
== パラメータ ==
 +
(Parameters)
  
; show_option_all : (''string'') Causes the HTML for the dropdown to allow you to select All of the categories.
+
; show_option_all  
; show_option_none : (''string'') Causes the HTML for the dropdown to allow you to select NONE of the categories.
+
: ''文字列''Causes the HTML for the dropdown to allow you to select All of the categories.
; orderby : (''string'') Key to sort options by. Valid values:
+
; show_option_none  
:* <tt>'ID'</tt> (Default)
+
: ''文字列''Causes the HTML for the dropdown to allow you to select NONE of the categories.
:* <tt>'name'</tt>
+
; orderby  
; order : (''string'') Sort order for options. Valid values:
+
: ''文字列'') ソートキー。有効値:
:* <tt>'ASC'</tt> (Default)
+
:* <code>'ID'</code> - カテゴリID(初期値)
:* <tt>'DESC'</tt>
+
:* <code>'name'</code> - カテゴリ名
; show_last_update : (''boolean'') Sets whether to display the date of the last post in each category. Valid values:
+
; order  
:* <tt>1</tt> (True)  
+
: ''文字列'') ソート順。有効値:
:* <tt>0 </tt> (False - Default)
+
:* <code>'ASC'</code> - 昇順(初期値)
; show_count : (''boolean'') Sets whether to display a count of posts in each category. Valid values:
+
:* <code>'DESC'</code> - 降順
:* <tt>1</tt> (True)
+
; show_last_update  
:* <tt>0</tt> (False - Default)
+
: ''真偽値'') 各カテゴリに属する投稿の最終更新日を表示するかどうか。有効値:
; hide_empty : (''boolean'') Sets whether to hide (not display) categories with no posts. Valid values:
+
:* <code>1</code> (True) - 表示
:* <tt>1</tt> (True - Default)
+
:* <code>0 </code> (False) - 非表示(初期値)
:* <tt>0</tt> (False)
+
; show_count  
; 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.
+
:* <code>1</code> (True) - 表示
; echo : (''boolean'') Display bookmarks (<tt>TRUE</tt>) or return them for use by PHP (<tt>FALSE</tt>). Defaults to <tt>TRUE</tt>.
+
:* <code>0</code> (False) - 非表示(初期値)
:* <tt>1</tt> (True - default)
+
; hide_empty  
:* <tt>0</tt> (False)
+
: ''真偽値'') 投稿のないカテゴリを隠す(非表示とする)かどうか。
; selected : (''integer'') Category ID of the category to be 'selected' or presented in the display box. Defaults to no category selected.
+
:* <code>1</code> (True) - 隠す(初期値)
; hierarchical : (''boolean'') Display categories in hierarchical fashion (child categories show indented). Defaults to <tt>FALSE</tt>.
+
:* <code>0</code> (False) - 表示
:* <tt>1</tt> (True)
+
; child_of  
:* <tt>0</tt> (False - Default)
+
: ''整数'') 指定した カテゴリID の子カテゴリのみを表示する。初期値なし。
; name : (''string'') Name assigned to the dropdown form. Defaults to 'cat'.
+
; exclude  
; class : (''string'') Class assinged to the dropdown form. Defaults to 'postform'.
+
: ''文字列'') 除外したいカテゴリID をカンマ区切りで指定。例えば、<code>'exclude=4,12'</code> とすれば、カテゴリID 4 12 を表示しない/値として返さない。初期値は除外カテゴリなし。
 +
; echo  
 +
: ''真偽値'') カテゴリリストを表示する(<code>TRUE</code>)か、PHP で使うために値を返す(<code>FALSE</code>)か。初期値は <code>TRUE</code>
 +
:* <code>1</code> (True) - 表示(初期値)
 +
:* <code>0</code> (False) - 値を返す
 +
; selected  
 +
: ''整数'') 表示ボックスで 'selected' としたいカテゴリID。(これを付けるとドロップダウンメニューなどの選択値の初期値となる。)デフォルトではどれにも付けない。
 +
; hierarchical  
 +
: ''真偽値'') カテゴリを階層形式で表示(子カテゴリをインデント)するか。初期値は <code>FALSE</code>
 +
:* <code>1</code> (True) - 階層形式
 +
:* <code>0</code> (False) - 親子同レベル(初期値)
 +
; name  
 +
: ''文字列'') ドロップダウンメニューのフォーム名。デフォルトは <code>'cat'</code>。
 +
; class  
 +
: ''文字列'') ドロップダウンフォームのクラス。デフォルトは <code>'postform'</code>。
 +
<!-- 前項と合わせて <code><nowiki><form name="cat" class="postform"></nowiki></code> のようになるのかも? -->
  
== Related ==
+
== 関連 ==
 +
(Related)
  
 +
{{DEFAULTSORT:wp_dropdown_categories}}
 
{{Tag Category Tags}}
 
{{Tag Category Tags}}
  
 
{{PHP Function Tag Footer}}
 
{{PHP Function Tag Footer}}
[[Category:New page created]]
 

2007年7月20日 (金) 22:30時点における版

この記事は翻訳時に編集が必要であるとマークされていました。その為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 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。