【Wordpress関数】the_category()(投稿に紐づいたカテゴリーのリンク付一覧)

[公開] 2024-07-14 / [更新] 2024-08-16

投稿に紐づいたカテゴリーを一覧(配列)で取得して「リンクと HTMLタグ( 又はセパレータ ) 付き」で出力。
投稿ページで、リンク付きカテゴリー一覧をサクッと表示できるWordpressテンプレートタグです。(ループ内のみ利用可能)

出力はセパレータ以外固定。
パラメータ以外の出力は固定となる為、要素を個別に設定したい場合は get_the_category()など他のテンプレートタグをお勧めします。

the_category()

呼び出しコード	パラメータ	説明
`<?php the_category(); ?>`	セパレータ指定なし	<ul><li> で出力
`<?php the_category(','); ?>`	セパレータ指定あり	セパレータで区切って出力

the_category() 利用例

セパレータ指定なし

<ul><LI> のリストで出力されます

PHP

 <?php the_category(); ?>
/* 出力結果 */
<ul class="post-categories">
  <li><a href="カテゴリーページURL" rel="category tag">カテゴリー名</a></li>
  <li><a href="カテゴリーページURL" rel="category tag">カテゴリー名</a></li>
</ul>

セパレータ「, 」で指定

指定したセパレータで繋いで出力されます。

PHP

<?php the_category(', '); ?>
/* 出力結果 */
<a href="カテゴリーページURL" rel="category tag">カテゴリー名</a>, <a href="カテゴリーページURL" rel="category tag">カテゴリー名</a>

<span> で囲む場合

特定のタグで囲みたい場合は、前後をタグで囲んだ上でセパレータに途中になるタグを入れます。
class なども設定可能です。

PHP

<span class="cat"><?php the_category('</span><span class="cat">'); ?></span>
/* 出力結果 */
<span class="cat"><a href="カテゴリーページURL" rel="category tag">カテゴリー名</a></span>
<span class="cat"><a href="カテゴリーページURL" rel="category tag">カテゴリー名</a></span>