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

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

「テンプレートタグ/the category」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(2.5: post_id パラメータ追加/ループ外でも使えるようになった?)
(パラメータ)
59行目: 59行目:
 
</div>
 
</div>
  
; separator  
+
 
: (''文字列'') 各カテゴリリンクの間に表示する文字列・記号。デフォルトでは、番号なし箇条書き(<code><nowiki><ul></nowiki></code>)でリンクを並べます。
+
{{引数|$separator|文字列|カテゴリー間を表示する文字列・記号. デフォルトでは、番号なし箇条書き(<code><nowiki><ul></nowiki></code>)でリンクを並べます。 初期設定は空の文字列になります。|オプション|空の文字列}}
; parents
+
 
: ''文字列'') 記事が子(サブ)カテゴリに属するとき、カテゴリリンクで「親子」関係をどう表示するか?オプション値:
+
{{引数|$parents|文字列|記事が子(サブ)カテゴリに属するときの表示の仕方。 オプションは、:<br> <big>&#x3000;&#9642;</big> <tt>'複数ある場合'</tt> -
:* <code>'multiple'</code> - 親・子カテゴリへのリンクを分けて表示
+
親と子のカテゴリーのリンクは、べつべつに表示し、「親子関係」となります。<br> <big>&#x3000;&#9642;</big> <tt>'1つしかない場合'</tt> 子カテゴリのみへのリンクを表示で、親子関係を表すリンクとなります。|オプション|空の文字列<br>'''付記''': 初期設定は子カデゴリへのリンクであり、親子関係はありません}}
:* <code>'single'</code> (初期値) - 子カテゴリのみへのリンクを表示(親子関係は表示しない)。
+
 
; post_id
+
<!-- 他の表現の可能性
: ''整数'') カテゴリを取得したい投稿ID。初期値は <code>false</code>(現在の投稿)。
+
 
 +
 
 +
{{引数|$parents|文字列|記事が子(サブ)カテゴリに属するときの表示の仕方。 オプションは:<ul>
 +
<li> <tt>'複数ある場合'</tt> - 親と子のカテゴリーのリンクは、べつべつに表示し、「親子関係」となります。</li>
 +
<li> <tt>'1つしかない場合'</tt> - 子カテゴリのみへのリンクを表示で、「親子関係」を表すリンクとなります。</li>
 +
</ul>
 +
|オプション|空の文字列<br>'''付記''': 初期設定は子カデゴリへのリンクであり、「親子関係」は表示しません。}}
 +
 
 +
{{引数|$parents|文字列|記事が子(サブ)カテゴリに属するときの表示の仕方。 オプションは:
 +
:* <tt>'複数ある場合'</tt> - 親と子のカテゴリーのリンクは、べつべつに表示し、「親子関係」となります。
 +
:* <tt>'1つしかない場合'</tt> - 子カテゴリのみへのリンクを表示で、 「親子関係」を表すリンクとなります。<br>'''付記''': 初期設定は子カデゴリへのリンクであり、「親子関係」は表示しません。}}
 +
 
 +
{{引数|$post_id|整数値|カテゴリを検索するためのPost ID。 初期値は <code>false</code> 現在のカテゴリリストを表します。|オプション|false}}
  
 
== ソースコード ==
 
== ソースコード ==

2014年5月17日 (土) 16:34時点における版

説明

このテンプレートタグ the_category は、現在の記事が属するカテゴリへのリンクを表示します。このタグはループの中で使わなければなりません。

情報募集: 2.5 以降はループ外でも使えますか?このページのノートをご覧ください。

使い方

<?php the_category( 'separator', 'parents', post_id ); ?>

用例

空白(スペース)区切り

この使い方では、区切り文字として空白を使ってカテゴリを並べます。

<p>Categories: <?php the_category(' '); ?></p>

カンマ区切り

カテゴリへのリンクをカンマで区切って表示(記事のカテゴリが複数あるとき)。

<p>This post is in: <?php the_category(', '); ?></p>
This post is in: WordPress, Computers, Blogging

矢印区切り

カテゴリへのリンクを矢印(>)で区切って表示。(: これを使うときは、> の後ろのカテゴリをサブカテゴリだと思う閲覧者がいるかもしれないことに気をつけて!)

<p>Categories: <?php the_category(' &gt; '); ?></p>
Categories: WordPress > Computers > Blogging

中点区切り

カテゴリへのリンクを中点(•)で区切って表示。

<p>Post Categories: <?php the_category(' &bull; '); ?></p>
Post Categories: WordPressComputersBlogging

パラメータ


テンプレート:引数

テンプレート:引数



カテゴリータグ: 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 関数型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。