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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Template Tags/wp_list_categories 18:16, 20 Jun 2007 MichaelH 版)
 
(一部訳)
1行目: 1行目:
== Description ==
+
原文・最新版: [[:en:Template Tags/wp_list_categories|WordPress Codex » wp_list_categories]]
The template tag, [[Template_Tags/wp_list_categories|wp_list_categories]], displays a list of [[Glossary#Category|Categories]] as links. When a Category link is clicked, all the posts in that Category will display on a Category Page using the appropriate [[Category Templates|Category Template]] dictated by the [[Template_Hierarchy|Template Hierarchy rules]].  [[Template_Tags/wp_list_categories|wp_list_categories]] works in much the same way as the two template tags replaced in WordPress 2.1, [[Template_Tags/list_cats|list_cats()]](deprecated), and [[Template_Tags/wp_list_cats|wp_list_cats()]](deprecated).
+
  
== Usage ==
+
== 説明 ==
%%% <?php wp_list_categories('arguments'); ?> %%%
+
(Description)
 +
 
 +
テンプレートタグ <code>wp_list_categories</code> は、リンク付き[[用語集#Category|カテゴリ]]リストを表示します。カテゴリリンクをクリックすると、[[:ja:Template Hierarchy|テンプレート階層ルール]]に基づく適切な[[Category Templates|カテゴリ・テンプレート]]([[:en:Category Templates|原文]])を用いたカテゴリページに、そのカテゴリに属する全ての記事が表示されます。<code>wp_list_categories</code> は、WordPress 2.1 で非推奨となった <code>[[:en:Template_Tags/list_cats|list_cats()]]</code> および <code>[[:en:Template_Tags/wp_list_cats|wp_list_cats()]]</code> の後継で、この二つとほぼ同じように動作します。
 +
 
 +
== 使い方 ==
 +
(Usage)
 +
 
 +
<?php wp_list_categories('arguments'); ?>
 +
 
 +
== 用例 ==
 +
(Examples)
 +
===デフォルトでの使い方===
 +
(Default Usage)
 +
 
 +
wp_list_categories();
  
== Examples ==
 
===Default Usage===
 
 
<pre>
 
<pre>
 
$defaults = array('show_option_all' => '', 'orderby' => 'name', 'order' => 'ASC',  
 
$defaults = array('show_option_all' => '', 'orderby' => 'name', 'order' => 'ASC',  
14行目: 25行目:
 
</pre>
 
</pre>
  
By default, the usage shows:
+
デフォルトでは次のように表示:
* No link to all categories
+
* No link to all categories(訳注:意図分からず。。)
* Sorts the list of Caegories in by the Category name in ascending order
+
* リストはカテゴリ名の昇順
* Does not show the last update (last updated post in each Category)
+
* (各カテゴリに属する最後に更新された記事の)最終更新日は非表示
* Displayed in an unordered list style
+
* 番号なし箇条書きリスト形式で表示
* Does not show the post count
+
* 投稿数は非表示
* Displays only Categories with posts
+
* 投稿のあるカテゴリのみ表示
* Sets the title attribute to the Category Description
+
* カテゴリ概要を title 属性にセット
* Is not restricted to the child_of any Category
+
* 子カテゴリの制限なし
* No feed or feed image used
+
* フィードへのリンクなし/リンク画像なし
* Does not exlude any Category and includes all Categories ('include' => '' is not shown above)
+
* 表示カテゴリの指定/除外なし(指定しないので、上記初期値に <code>'include' => ''</code> が載っていない)
* Shows the Categories in hierarchical indented fashion
+
* カテゴリレベルをインデント表示(ネスト表示、ツリー表示)
* Display Category as the heading over the list
+
* リストの前に、見出しとして「Category」(日本語化ファイルで定義されていればその文字列)を表示
* No SQL LIMIT is imposed ('number' => 0 is not shown above)
+
* SQL LIMIT なし(<code>'number' => 0</code> は上記初期値に載っていない)
+
wp_list_categories();
+
  
=== Include or Exclude Categories ===
+
=== カテゴリの指定・除外 ===
To sort categories alphabetically and include only the categories with IDs of 16, 3, 9 and 5, you could write the following code:
+
(Include or Exclude Categories)
  
<div style="padding: 1em; border: 1px dashed #2f6fab;
+
カテゴリをアルファベット順にソート、カテゴリID 16, 3, 9, 5 のみを表示したいとき、次のようにコードを書きます:
color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;">
+
<pre class="expample">
<tt>
+
<ul>
&lt;ul&gt; <br />
+
<?php
&lt;?php<br />
+
wp_list_categories('orderby=name&include=3,5,9,16'); ?>
wp_list_categories('orderby=name&include=3,5,9,16'); ?&gt; <br />  
+
</ul>
&lt;/ul&gt;
+
</pre>
</tt>
+
</div>
+
  
The following example displays category links sorted by name, shows the number of posts for each category, and excludes the category with the ID of 10 from the list. 
+
次の例は、カテゴリ名順にソート、各カテゴリの投稿数を表示、リストからカテゴリID 10 を除外。
+
<pre class="expample">
<div style="padding: 1em; border: 1px dashed #2f6fab;
+
<ul>
color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;">
+
<?php
<tt>
+
wp_list_categories('orderby=name&show_count=1&exclude=10'); ?>
&lt;ul&gt; <br />
+
</ul>
&lt;?php<br />
+
</pre>
wp_list_categories('orderby=name&show_count=1&exclude=10'); ?&gt; <br />  
+
&lt;/ul&gt;
+
</tt>
+
</div>
+
  
=== Display or Hide the List Heading ===
+
=== リストの見出しの表示/非表示 ===
The '''title_li''' parameter sets or hides a title or heading for the category list generated by ''wp_list_categories''. It defaults to <tt>'(__('Categories')'</tt>, i.e. it displays the word "Categories" as the list's heading. If the parameter is set to a null or empty value, no heading is displayed. The following example code excludes categories with IDs 4 and 7 and hides the list heading:
+
(Display or Hide the List Heading)
  
<div style="padding: 1em; border: 1px dashed #2f6fab;
+
'''title_li''' パラメータは、生成されるカテゴリリストの見出しを設定したり隠したりします。初期値は <tt>'(__('Categories')'</tt>で、見出しとして "Categories"(日本語化で「カテゴリ」)といった語句を表示します。このパラメータに null や空の値をセットすると、見出しを表示しません。次のコードは、カテゴリID 4、7 以外を表示し、見出しを非表示とする例:
color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;">
+
<tt>
+
&lt;ul&gt; <br />
+
&lt;?php<br />
+
wp_list_categories('exclude=4,7&title_li='); ?&gt; <br />
+
&lt;/ul&gt;
+
</tt>
+
</div>
+
  
In the following example, only Cateogories with IDs 9, 5, and 23 are included in the list and the heading text has been changed to the word "Poetry", with a heading style of <tt><nowiki><h2></nowiki></tt>:
+
<pre class="expample">
 +
<ul>
 +
<?php
 +
wp_list_categories('exclude=4,7&title_li='); ?>
 +
</ul>
 +
</pre>
  
<div style="padding: 1em; border: 1px dashed #2f6fab;
+
次の例は、カテゴリID 9、5、23 のみを表示、見出しを <code><nowiki><h2></nowiki></code> タグ付きの "Poetry" 語句に変更:
color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;">
+
 
<tt>
+
<pre class="expample">
&lt;ul&gt; <br />
+
<ul>
&lt;?php<br />
+
<?php
wp_list_categories('include=5,9,23&title_li=&lt;h2&gt;' . __('Poetry') . '&lt;/h2&gt;' ); ?&gt; <br />  
+
wp_list_categories('include=5,9,23&title_li=<h2>' . __('Poetry') . '</h2>' ); ?>
&lt;/ul&gt;
+
</ul>
</tt>
+
</pre>
</div>
+
 
 +
訳注: <code>(__('Categories')</code>、<code>__('Poetry')</code> は、ローカライズ(日本語化)対応の書き方です。括弧内の文字列とその訳語を日本語化ファイルで定義すれば、訳語に置換されて表示されます。
 +
 
 +
=== 子カテゴリのみの表示 ===
 +
(Only Show Children of a Category)
  
=== Only Show Children of a Category ===
 
 
The following example code generates category links, sorted by ID, only for the children of the category with ID 8; it shows the number of posts per category and hides category descriptions from the <tt>title</tt> attribute of the generated links. '''Note:''' If there are no posts in a parent Category, the parent Category will not display.
 
The following example code generates category links, sorted by ID, only for the children of the category with ID 8; it shows the number of posts per category and hides category descriptions from the <tt>title</tt> attribute of the generated links. '''Note:''' If there are no posts in a parent Category, the parent Category will not display.
  
<div style="padding: 1em; border: 1px dashed #2f6fab;
+
<pre class="expample">
color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;">
+
<ul>
<tt>
+
<?php wp_list_categories('orderby=id&show_count=1
&lt;ul&gt;<br />
+
&use_desc_for_title=0&child_of=8'); ?>
&lt;?php wp_list_categories('orderby=id&show_count=1<br />&use_desc_for_title=0&child_of=8'); ?&gt; <br />
+
</ul>
&lt;/ul&gt;
+
</pre>
</tt>
+
</div>
+
  
=== Display Categories with RSS Feed Links ===
+
=== フィードリンク付きカテゴリ表示 ===
The following example generates Category links sorted by name, shows the number of posts per Category, and displays links to the RSS feed for each Category.
+
(Display Categories with RSS Feed Links)
  
<div style="padding: 1em; border: 1px dashed #2f6fab;
+
カテゴリ名でソート、各カテゴリの投稿数を表示、各カテゴリの RSS フィードへのリンクを表示する例:
color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;">
+
<tt>
+
&lt;ul&gt;<br />
+
&lt;?php<br />
+
wp_list_categories('orderby=name&show_count=1&feed=RSS'); ?&gt; <br />
+
&lt;/ul&gt;
+
</tt>
+
</div>
+
  
To replace the rss link with a feed icon, you could write:
+
<pre class="expample">
 +
<ul>
 +
<?php
 +
wp_list_categories('orderby=name&show_count=1&feed=RSS'); ?>
 +
</ul>
 +
</pre>
 +
 
 +
RSS リンク部分をフィードアイコンで表示するには:
 +
 
 +
<pre class="expample">
 +
<ul>
 +
<?php
 +
wp_list_categories('orderby=name&show_count=1
 +
&feed_image=/images/rss.gif'); ?>
 +
</ul>
 +
</pre>
  
<div style="padding: 1em; border: 1px dashed #2f6fab;
+
=== カテゴリリストのマークアップ様式 ===
color: Black; background-color: #f9f9f9; line-height: 1.1em; font-size: 0.9em;">
+
(Markup and Styling of Category Lists)
<tt>
+
&lt;ul&gt;<br />
+
&lt;?php<br />
+
wp_list_categories('orderby=name&show_count=1<br />
+
&feed_image=/images/rss.gif'); ?&gt; <br />
+
&lt;/ul&gt;
+
</tt>
+
</div>
+
  
=== Markup and Styling of Category Lists ===
 
 
By default, '''wp_list_categories()''' generates list items <tt><nowiki><li></nowiki></tt> for an unordered list <tt><nowiki><ul></nowiki></tt>. All list items generated by '''wp_list_categories()''' are marked with the class <tt>"page_item"</tt>. When '''wp_list_categories()''' is called while displaying a Category Page, the list item for that Page will be given the additional class <tt>"current_page_item"</tt>:
 
By default, '''wp_list_categories()''' generates list items <tt><nowiki><li></nowiki></tt> for an unordered list <tt><nowiki><ul></nowiki></tt>. All list items generated by '''wp_list_categories()''' are marked with the class <tt>"page_item"</tt>. When '''wp_list_categories()''' is called while displaying a Category Page, the list item for that Page will be given the additional class <tt>"current_page_item"</tt>:
  
133行目: 132行目:
 
</pre>
 
</pre>
  
You can style these classes with [[Glossary#CSS|CSS selectors]] :
+
You can style these classes with [[用語集#CSS|CSS selectors]] :
  
 
   .page_item { ... }
 
   .page_item { ... }
 
   .current_page_item { ... }
 
   .current_page_item { ... }
 
----
 
----
'''Note:''' The list items generated by ''wp_list_categories'' (unless the '''style''' parameter is set to ''none'') require an opening and closing <tt><nowiki><ul></nowiki></tt> tag. See the [[Template_Tags/wp_list_categories#Examples|examples]] below.
+
'''Note:''' The list items generated by ''wp_list_categories'' (unless the '''style''' parameter is set to ''none'') require an opening and closing <tt><nowiki><ul></nowiki></tt> tag. See the [[#用例|examples]] below.
 
----
 
----
  
== Parameters ==
+
== パラメータ ==
; show_option_all : (''string'') A non-blank values causes the display of a link to all categories if the style is set to list.  The default value is not to display a link to all.
+
(Parameters)
 
+
; orderby : (''string'') Sort categories alphabetically, by unique Category ID, or by the count of posts in that Category. The default is sort by category name. Valid values:
+
:* <tt>ID</tt>
+
:* <tt>name</tt> - default
+
:* <tt>count</tt>
+
 
+
; order : (''string'') Sort order for categories (either ascending or descending). The default is ''ascending''. Valid values:
+
:* <tt>ASC</tt> - default
+
:* <tt>DESC</tt>
+
 
+
; show_last_updated : (''boolean'') Should the last updated timestamp for posts  be displayed (TRUE) or not (FALSE). Defaults to FALSE.
+
: * <tt>1 (true) </tt>
+
: * <tt>0 (false) </tt> - default
+
 
+
; style : (''string'') Style to display the categories list in. A value of ''list'' displays the categories as list items while ''none'' generates no special display method (the list items are separated by <tt><nowiki><br></nowiki></tt> tags). The default setting is ''list'' (creates list items for an unordered list). See [[Template_Tags/wp_list_categories#Markup_and_Styling_of_Category_Lists|the markup section]] for more. Valid values:
+
:* <tt>list</tt> - default.
+
:* <tt>none</tt>
+
 
+
; show_count : (''boolean'') Toggles the display of the current count of posts in each category. The default is ''false'' (do not show post counts). Valid values:
+
:* <tt>1 (true)</tt>
+
:* <tt>0 (false)</tt> - default
+
 
+
; hide_empty : (''boolean'') Toggles the display of categories with no posts. The default is ''true'' (hide empty categories). Valid values:
+
:* <tt>1 (true)</tt> - default
+
:* <tt>0 (false)</tt>
+
 
+
; use_desc_for_title : (''boolean'') Sets whether a category's [[Manage_Categories_SubPanel|description]] is inserted into the <tt>title</tt> attribute of the links created (i.e. <nowiki><a title="<em>Category Description</em>" href="...</nowiki>). The default is ''true'' (category descriptions will be inserted). Valid values:
+
:* <tt>1 (true)</tt> - default
+
:* <tt>0 (false)</tt>
+
 
+
; child_of : (''integer'') Only display categories that are children of the category identified by this parameter.  There is no default for this parameter. If the parameter is used, the '''hide_empty''' parameter is set to ''false''.
+
 
+
; '''feed''' (''string''):Display a link to each category's [[Glossary#RSS|rss-2]] feed and set the link text to display. The default is ''no text and no feed displayed''.
+
 
+
; '''feed_image''' : (''string'') Set a URI for an image (usually an rss feed icon) to act as a link to each categories' rss-2 feed. This parameter overrides the '''feed''' parameter. There is no default for this parameter.
+
 
+
; exclude : (''string'') Exclude one or more categories from the results. This parameter takes a comma-separated list of categories by unique ID, in ascending order. See [[Template_Tags/wp_list_categories#Include_or_Exclude_Categories|the example]].  The ''child_of'' parameter is automatically set to false.
+
 
+
; include : (''string'') Only include the categories detailed in a comma-separated list by unique ID, in ascending order. See [[Template_Tags/wp_list_categories#Include_or_Exclude_Categories|the example]].
+
 
+
; hierarchical : (''boolean'') Display sub-categories as inner list items (below the parent list item) or inline.  The default is ''true'' (display sub-categories below the parent list item). Valid values:
+
:* <tt>1 (true)</tt> - default
+
:* <tt>0 (false)</tt>
+
 
+
; title_li : (''string'') Set the title and style of the outer list item. Defaults to "_Categories".  If present but empty, the outer list item will not be displayed. See below for [[#Display or Hide the List Heading|examples]].
+
  
; number : (''integer'') Sets the number of Categories to displayThis causes the SQL LIMIT value to be defined. Default to no LIMIT.
+
; show_option_all
 +
: ''文字列'') A non-blank values causes the display of a link to all categories if the style is set to listThe default value is not to display a link to all.(訳注:意図分からず。。)
 +
; orderby
 +
: (''文字列'') カテゴリのソート項目:アルファベット、カテゴリID、カテゴリの投稿数。初期値はカテゴリ名でソート。有効値:
 +
:* <code>ID</code>
 +
:* <code>name</code> - 初期値
 +
:* <code>count</code>
 +
; order
 +
: (''文字列'') カテゴリのソート順(昇順または降順)。初期値は ''昇順''。有効値:
 +
:* <code>ASC</code> - 初期値
 +
:* <code>DESC</code>
 +
; show_last_updated
 +
: (''論理値'') (各カテゴリに属する)投稿の最終更新日を表示するか。表示する(TRUE) または 非表示(FALSE)。初期値は非表示(FALSE)。
 +
: * <code>1 (true) </code>
 +
: * <code>0 (false) </code> - 初期値
 +
; style
 +
: (''文字列'') カテゴリリストの表示形式。値 ''list'' は、カテゴリを箇条書きとして表示。''none'' は表示形式なし(各カテゴリは <code><nowiki><br></nowiki></code>(改行)で区切られる)。[[#Markup_and_Styling_of_Category_Lists|the markup section]] 参照。有効値:
 +
:* <code>list</code> - 初期値
 +
:* <code>none</code>
 +
; show_count
 +
: (''論理値'') 各カテゴリに投稿数を表示するか。初期値は ''false''(非表示)。有効値:
 +
:* <code>1 (true)</code>
 +
:* <code>0 (false)</code> - 初期値
 +
; hide_empty
 +
: (''論理値'') 投稿のないカテゴリを非表示にするか。初期値は ''true''(空のカテゴリを隠す)。有効値:
 +
:* <code>1 (true)</code> - 初期値
 +
:* <code>0 (false)</code>
 +
; use_desc_for_title
 +
: (''論理値'') カテゴリの[[:en:Manage Categories SubPanel|概要]]をリンク(アンカータグ)の <code>title</code> 属性に挿入(<nowiki><a title="<em>カテゴリ概要</em>" href="...</nowiki> のように)するか。初期値は ''true''(カテゴリ概要を挿入)。有効値:
 +
:* <code>1 (true)</code> - 初期値
 +
:* <code>0 (false)</code>
 +
; child_of
 +
: (''整数'') このパラメータで指定したカテゴリID の子カテゴリのみ表示。初期値なし。このパラメータを使うと、'''hide_empty''' パラメータに ''false'' がセットされる。
 +
; feed
 +
: (''文字列'')各カテゴリの [[用語集#RSS|rss-2]] フィードへのリンクを表示、そのリンク文字列を設定する。初期値は ''フィードへのリンク・リンク文字列なし''。
 +
; feed_image
 +
: (''文字列'') 各カテゴリの rss-2 フィードへのリンクを画像(通常は RSSフィードアイコン)で表示したいときに、その画像の URI を設定。このパラメータは '''feed''' パラメータより優先(リンク文字列の替わりに画像)。初期値なし。
 +
; exclude
 +
: (''文字列'') 指定したカテゴリ(複数可)をリストから除外。除外するカテゴリID をカンマ区切りで昇順に指定。[[#カテゴリの指定・除外|用例]]を参照。''child_of'' パラメータは自動的に無効となります。
 +
; include
 +
: (''文字列'') 指定したカテゴリID のみリストに表示。カンマ区切りで昇順に指定。[[#カテゴリの指定・除外|用例]]を参照。
 +
; hierarchical
 +
: (''論理値'') サブカテゴリを箇条書き項目の内側(親カテゴリより下位レベル)に表示するか、親と同レベルで表示するか。(つまり、箇条書きを入れ子・ツリー表示にするか否か。)初期値は ''true''(サブカテゴリを親より下位レベルに表示)。有効値:
 +
:* <code>1 (true)</code> - 初期値
 +
:* <code>0 (false)</code>
 +
; title_li
 +
: (''文字列'') 箇条書きの外側に表示するタイトルと表示形式。デフォルトは "_Categories"。このパラメータを中味を空で指定すると、箇条書きの外側には何も表示しません。[[#リストの見出しの表示/非表示|用例]]を参照。
 +
; number
 +
: (''整数'') 表示するカテゴリ数を設定。This causes the SQL LIMIT value to be defined. 初期値は無制限。
  
 
== Related ==
 
== Related ==

2007年7月18日 (水) 21:38時点における版

原文・最新版: WordPress Codex » wp_list_categories

説明

(Description)

テンプレートタグ wp_list_categories は、リンク付きカテゴリリストを表示します。カテゴリリンクをクリックすると、テンプレート階層ルールに基づく適切なカテゴリ・テンプレート原文)を用いたカテゴリページに、そのカテゴリに属する全ての記事が表示されます。wp_list_categories は、WordPress 2.1 で非推奨となった list_cats() および wp_list_cats() の後継で、この二つとほぼ同じように動作します。

使い方

(Usage)

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

用例

(Examples)

デフォルトでの使い方

(Default Usage)

wp_list_categories();
$defaults = array('show_option_all' => '', 'orderby' => 'name', 'order' => 'ASC', 
'show_last_update' => 0, 'style' => 'list','show_count' => 0, 'hide_empty' => 1, 
'use_desc_for_title' => 1, 'child_of' => 0, 'feed' => '', 'feed_image' => '', 
'exclude' => '', 'hierarchical' => true, 'title_li' => __('Categories'));

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

  • No link to all categories(訳注:意図分からず。。)
  • リストはカテゴリ名の昇順
  • (各カテゴリに属する最後に更新された記事の)最終更新日は非表示
  • 番号なし箇条書きリスト形式で表示
  • 投稿数は非表示
  • 投稿のあるカテゴリのみ表示
  • カテゴリ概要を title 属性にセット
  • 子カテゴリの制限なし
  • フィードへのリンクなし/リンク画像なし
  • 表示カテゴリの指定/除外なし(指定しないので、上記初期値に 'include' => が載っていない)
  • カテゴリレベルをインデント表示(ネスト表示、ツリー表示)
  • リストの前に、見出しとして「Category」(日本語化ファイルで定義されていればその文字列)を表示
  • SQL LIMIT なし('number' => 0 は上記初期値に載っていない)

カテゴリの指定・除外

(Include or Exclude Categories)

カテゴリをアルファベット順にソート、カテゴリID 16, 3, 9, 5 のみを表示したいとき、次のようにコードを書きます:

<ul>
<?php
wp_list_categories('orderby=name&include=3,5,9,16'); ?>
</ul>

次の例は、カテゴリ名順にソート、各カテゴリの投稿数を表示、リストからカテゴリID 10 を除外。

<ul>
<?php
wp_list_categories('orderby=name&show_count=1&exclude=10'); ?>
</ul>

リストの見出しの表示/非表示

(Display or Hide the List Heading)

title_li パラメータは、生成されるカテゴリリストの見出しを設定したり隠したりします。初期値は '(__('Categories')'で、見出しとして "Categories"(日本語化で「カテゴリ」)といった語句を表示します。このパラメータに null や空の値をセットすると、見出しを表示しません。次のコードは、カテゴリID 4、7 以外を表示し、見出しを非表示とする例:

<ul>
<?php
wp_list_categories('exclude=4,7&title_li='); ?>
</ul>

次の例は、カテゴリID 9、5、23 のみを表示、見出しを <h2> タグ付きの "Poetry" 語句に変更:

<ul>
<?php
wp_list_categories('include=5,9,23&title_li=<h2>' . __('Poetry') . '</h2>' ); ?>
</ul>

訳注: (__('Categories')__('Poetry') は、ローカライズ(日本語化)対応の書き方です。括弧内の文字列とその訳語を日本語化ファイルで定義すれば、訳語に置換されて表示されます。

子カテゴリのみの表示

(Only Show Children of a Category)

The following example code generates category links, sorted by ID, only for the children of the category with ID 8; it shows the number of posts per category and hides category descriptions from the title attribute of the generated links. Note: If there are no posts in a parent Category, the parent Category will not display.

<ul>
<?php wp_list_categories('orderby=id&show_count=1
&use_desc_for_title=0&child_of=8'); ?>
</ul>

フィードリンク付きカテゴリ表示

(Display Categories with RSS Feed Links)

カテゴリ名でソート、各カテゴリの投稿数を表示、各カテゴリの RSS フィードへのリンクを表示する例:

<ul>
<?php 
wp_list_categories('orderby=name&show_count=1&feed=RSS'); ?>
</ul>

RSS リンク部分をフィードアイコンで表示するには:

<ul>
<?php 
wp_list_categories('orderby=name&show_count=1
&feed_image=/images/rss.gif'); ?>
</ul>

カテゴリリストのマークアップ様式

(Markup and Styling of Category Lists)

By default, wp_list_categories() generates list items <li> for an unordered list <ul>. All list items generated by wp_list_categories() are marked with the class "page_item". When wp_list_categories() is called while displaying a Category Page, the list item for that Page will be given the additional class "current_page_item":

<ul>
   <li class="page_item current_page_item">
     [the current page]
   </li>
   <li class="page_item">
     [another page]
   </li>
</ul>

You can style these classes with CSS selectors :

 .page_item { ... }
 .current_page_item { ... }

Note: The list items generated by wp_list_categories (unless the style parameter is set to none) require an opening and closing <ul> tag. See the examples below.


パラメータ

(Parameters)

show_option_all
文字列) A non-blank values causes the display of a link to all categories if the style is set to list. The default value is not to display a link to all.(訳注:意図分からず。。)
orderby
文字列) カテゴリのソート項目:アルファベット、カテゴリID、カテゴリの投稿数。初期値はカテゴリ名でソート。有効値:
  • ID
  • name - 初期値
  • count
order
文字列) カテゴリのソート順(昇順または降順)。初期値は 昇順。有効値:
  • ASC - 初期値
  • DESC
show_last_updated
(論理値) (各カテゴリに属する)投稿の最終更新日を表示するか。表示する(TRUE) または 非表示(FALSE)。初期値は非表示(FALSE)。
* 1 (true)
* 0 (false) - 初期値
style
文字列) カテゴリリストの表示形式。値 list は、カテゴリを箇条書きとして表示。none は表示形式なし(各カテゴリは <br>(改行)で区切られる)。the markup section 参照。有効値:
  • list - 初期値
  • none
show_count
論理値) 各カテゴリに投稿数を表示するか。初期値は false(非表示)。有効値:
  • 1 (true)
  • 0 (false) - 初期値
hide_empty
論理値) 投稿のないカテゴリを非表示にするか。初期値は true(空のカテゴリを隠す)。有効値:
  • 1 (true) - 初期値
  • 0 (false)
use_desc_for_title
論理値) カテゴリの概要をリンク(アンカータグ)の title 属性に挿入(<a title="<em>カテゴリ概要</em>" href="... のように)するか。初期値は true(カテゴリ概要を挿入)。有効値:
  • 1 (true) - 初期値
  • 0 (false)
child_of
整数) このパラメータで指定したカテゴリID の子カテゴリのみ表示。初期値なし。このパラメータを使うと、hide_empty パラメータに false がセットされる。
feed
文字列)各カテゴリの rss-2 フィードへのリンクを表示、そのリンク文字列を設定する。初期値は フィードへのリンク・リンク文字列なし
feed_image
文字列) 各カテゴリの rss-2 フィードへのリンクを画像(通常は RSSフィードアイコン)で表示したいときに、その画像の URI を設定。このパラメータは feed パラメータより優先(リンク文字列の替わりに画像)。初期値なし。
exclude
文字列) 指定したカテゴリ(複数可)をリストから除外。除外するカテゴリID をカンマ区切りで昇順に指定。用例を参照。child_of パラメータは自動的に無効となります。
include
文字列) 指定したカテゴリID のみリストに表示。カンマ区切りで昇順に指定。用例を参照。
hierarchical
論理値) サブカテゴリを箇条書き項目の内側(親カテゴリより下位レベル)に表示するか、親と同レベルで表示するか。(つまり、箇条書きを入れ子・ツリー表示にするか否か。)初期値は true(サブカテゴリを親より下位レベルに表示)。有効値:
  • 1 (true) - 初期値
  • 0 (false)
title_li
文字列) 箇条書きの外側に表示するタイトルと表示形式。デフォルトは "_Categories"。このパラメータを中味を空で指定すると、箇条書きの外側には何も表示しません。用例を参照。
number
整数) 表示するカテゴリ数を設定。This causes the SQL LIMIT value to be defined. 初期値は無制限。

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()


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


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