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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(2.5: post_id パラメータ追加/ループ外でも使えるようになった?)
(関連)
 
(4人の利用者による、間の12版が非表示)
1行目: 1行目:
 +
<div id="Description">
 
== 説明 ==
 
== 説明 ==
 +
</div>
  
このテンプレートタグ '''<code>the_category</code>''' は、現在の記事が属するカテゴリへのリンクを表示します。このタグは[[The Loop|ループ]]の中で使わなければなりません。
+
このテンプレートタグは、現在の記事が属するカテゴリーへのリンクを表示します。
 +
必ず、[[The Loop|ループ]]の中で使わなければなりません。
  
 
{{Notice|情報募集|2.5 以降はループ外でも使えますか?||ループ外での使用可否}}
 
{{Notice|情報募集|2.5 以降はループ外でも使えますか?||ループ外での使用可否}}
9行目: 12行目:
 
</div>
 
</div>
  
  <?php the_category( 'separator', 'parents', post_id ); ?>
+
  <?php the_category( $separator, $parents, $post_id ); ?>
 +
 
 +
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
 +
 
 +
{{Parameter|$separator|文字列|カテゴリーへのリンクを区切る文字列や記号。デフォルトでは、番号なし箇条書き(<code><nowiki><ul></nowiki></code>)でリンクを並べます。空の文字列を指定するとデフォルト表示になります。|オプション|空の文字列}}
 +
 
 +
{{Parameter|$parents|文字列|記事が子(サブ)カテゴリーに属するときの表示の仕方。オプションは:<br> <big>&#x3000;&#9642;</big> <tt>'multiple'</tt> - 親と子のカテゴリーへのリンクを別々に表示し、見た目は「親/子」になります。<br> <big>&#x3000;&#9642;</big> <tt>'single'</tt> - 子カテゴリーへのリンクのみを表示しますが、見た目は「親/子」になります。|オプション|空の文字列<br>'''付記''': 初期設定は子カデゴリーへのリンクであり、親子関係は表示しません。}}
 +
 
 +
<!-- 他の表現の可能性
 +
 
 +
{{Parameter|$parents|文字列|記事が子(サブ)カテゴリに属するときの表示の仕方。オプションは:<ul>
 +
<li> <tt>'multiple'</tt> - 親と子のカテゴリーへのリンクを別々に表示し、見た目は「親/子」になります。</li>
 +
<li> <tt>'single'</tt> - 子カテゴリーへのリンクのみを表示しますが、見た目は「親/子」になります。</li>
 +
</ul>
 +
|オプション|空の文字列<br>'''付記''': 初期設定は子カデゴリーへのリンクであり、親子関係は表示しません。}}
 +
 
 +
{{Parameter|$parents|文字列|記事が子(サブ)カテゴリに属するときの表示の仕方。オプションは:
 +
:* <tt>'multiple'</tt> - 親と子のカテゴリーへのリンクを別々に表示し、見た目は「親/子」になります。
 +
:* <tt>'single'</tt> - 子カテゴリーへのリンクのみを表示しますが、見た目は「親/子」になります。<br>'''付記''': 初期設定は子カデゴリーへのリンクであり、親子関係は表示しません。}}
 +
 
 +
-->
 +
 
 +
{{Parameter|$post_id|整数|カテゴリーを取得する投稿の ID。 初期値は <code>false</code> で、現在の投稿に付けられたカテゴリーのリストになります。|オプション|false}}
  
 
<div id="Examples">
 
<div id="Examples">
19行目: 46行目:
 
</div>
 
</div>
  
この使い方では、区切り文字として空白を使ってカテゴリを並べます。
+
この使い方では、区切り文字として空白を使ってカテゴリーを並べます。
  
 
<pre><p>Categories: <?php the_category(' '); ?></p></pre>
 
<pre><p>Categories: <?php the_category(' '); ?></p></pre>
26行目: 53行目:
  
 
<div id="Separated_by_Comma">
 
<div id="Separated_by_Comma">
=== カンマ区切り ===
+
=== コンマ区切り ===
 
</div>
 
</div>
  
カテゴリへのリンクをカンマで区切って表示(記事のカテゴリが複数あるとき)。
+
カテゴリーへのリンクをコンマで区切って表示(記事のカテゴリが複数あるとき)。
  
 
<pre><p>This post is in: <?php the_category(', '); ?></p></pre>
 
<pre><p>This post is in: <?php the_category(', '); ?></p></pre>
55行目: 82行目:
 
<div class="example">Post Categories: [[#Examples|WordPress]] &bull; [[#Examples|Computers]] &bull; [[#Examples|Blogging]]</div>
 
<div class="example">Post Categories: [[#Examples|WordPress]] &bull; [[#Examples|Computers]] &bull; [[#Examples|Blogging]]</div>
  
<div id="Parameters">
+
<div id="Source Code">
== パラメータ ==
+
== ソースコード ==
 
</div>
 
</div>
 
+
* <tt>the_category()</tt> {{Trac|wp-includes/category-template.php}} にあります。
; separator
+
: (''文字列'') 各カテゴリリンクの間に表示する文字列・記号。デフォルトでは、番号なし箇条書き(<code><nowiki><ul></nowiki></code>)でリンクを並べます。
+
; parents
+
: (''文字列'') 記事が子(サブ)カテゴリに属するとき、カテゴリリンクで「親子」関係をどう表示するか?オプション値:
+
:* <code>'multiple'</code> - 親・子カテゴリへのリンクを分けて表示
+
:* <code>'single'</code> (初期値) - 子カテゴリのみへのリンクを表示(親子関係は表示しない)。
+
; post_id
+
: (''整数'') カテゴリを取得したい投稿ID。初期値は <code>false</code>(現在の投稿)。
+
 
+
== ソースコード ==
+
* {{BrowseSource|wp-includes/category-template.php}}
+
  
 
== 更新履歴 ==
 
== 更新履歴 ==
 
* [[Version 2.5|2.5]] : ''post_id'' パラメータが追加されました。
 
* [[Version 2.5|2.5]] : ''post_id'' パラメータが追加されました。
 
{{原文|Template Tags/the_category|81629}}<!-- 16:42, 4 January 2010 Bono 版 -->
 
  
 
<div id="Related">
 
<div id="Related">
80行目: 94行目:
 
</div>
 
</div>
  
{{Tag Category Tags}}
+
{{Tag Post Tags}}
 +
 
 +
{{Tag Category Tags}}, [[関数リファレンス/the_taxonomies|the_taxonomies()]]
 +
{{Tag Footer}}
  
{{PHP Function Tag Footer}}
+
{{原文|Template Tags/the_category|126772}} <!-- 02:34, 7 February 2013 Bcworkz 版 -->
  
 
{{DEFAULTSORT:The_category}}
 
{{DEFAULTSORT:The_category}}
 +
[[Category:テンプレートタグ]]
 
[[Category:wp2.5]]
 
[[Category:wp2.5]]
  
 
[[en:Template Tags/the_category]]
 
[[en:Template Tags/the_category]]
 +
[[ru:Теги шаблонов/the_category]]

2015年5月27日 (水) 07:54時点における最新版

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

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

使い方

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

パラメータ

$separator
文字列) (オプション) カテゴリーへのリンクを区切る文字列や記号。デフォルトでは、番号なし箇条書き(<ul>)でリンクを並べます。空の文字列を指定するとデフォルト表示になります。
初期値: 空の文字列
$parents
文字列) (オプション) 記事が子(サブ)カテゴリーに属するときの表示の仕方。オプションは:
 ▪ 'multiple' - 親と子のカテゴリーへのリンクを別々に表示し、見た目は「親/子」になります。
 ▪ 'single' - 子カテゴリーへのリンクのみを表示しますが、見た目は「親/子」になります。
初期値: 空の文字列
付記: 初期設定は子カデゴリーへのリンクであり、親子関係は表示しません。


$post_id
整数) (オプション) カテゴリーを取得する投稿の ID。 初期値は false で、現在の投稿に付けられたカテゴリーのリストになります。
初期値: false

用例

空白(スペース)区切り

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

<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

ソースコード

更新履歴

  • 2.5 : post_id パラメータが追加されました。


投稿タグ: body_class(), next_image_link(), next_post_link(), next_posts_link(), post_class(), post_password_required(), posts_nav_link(), previous_image_link(), previous_post_link(), previous_posts_link(), single_post_title(), sticky_class(), the_category(), the_category_rss(), the_content(), the_content_rss(), the_excerpt(), the_excerpt_rss(), the_ID(), the_meta(), the_shortlink(), the_tags(), the_title(), the_title_attribute(), the_title_rss(), wp_link_pages(),


カテゴリータグ: 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() , the_taxonomies()

関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Template Tags/the_category最新版との差分