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

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

テンプレートタグ/the category

提供: WordPress Codex 日本語版
移動先: 案内検索

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

情報募集: 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最新版との差分