Mill's Note

【Wordpress関数】get_the_category()

/

投稿に紐づいたカテゴリーを配列で取得する、Wordpressテンプレートタグ。
カテゴリーの様々な情報を取得・出力することができます。

投稿IDを指定することでループ外でも使用できます。

get_the_category() 呼び出しコード

呼び出しコードパラメータ説明
<?php $cats = get_the_category(); ?>なし現在のページに紐づくカテゴリー (投稿ループ内)
<?php $cats = get_the_category(投稿ID); ?>投稿ID指定した投稿に紐づくカテゴリー (ループ外)

get_the_category() 戻り値

変数名内容
term_idintカテゴリーID
namestringカテゴリー名
slugstringカテゴリースラッグ
parentint親カテゴリーID
countint記事数
descriptionstringカテゴリー説明
taxonomystringtaxonomy名
term_taxonomy_idint taxonomy ID
あまり使用しない戻り値、及び、エイリアスは記載していません。

get_the_category() の使用例

カテゴリーの情報を呼び出し、必要な戻り値を利用して出力します。

最初、又は、指定番目のカテゴリーを1件だけ取得

カテゴリー は配列で取得しますので、何番目かを[n] として指定。
配列は 0 から数えますので、最初のカテゴリーなら [0] を指定します

PHP
<?php
  $terms = get_the_category();
  /*  配列の〇番目を指定 - 例は最初のカテゴリー  */
  $name = $terms[0]->name;
  $id   = $terms[0]->term_id;
?>
<a href="<?php echo get_category_link($id); ?>"><?php echo $name; ?></a>

紐づくカテゴリーをまとめて取得

foreach{ } で紐づいている全てのタグを出力します。

PHP
<?php
  $terms = get_the_category();
  foreach ($terms as $term){
    $name = $term->name;
    $id   = $term->term_id;
?>
  <a href="<?php echo get_category_link($id); ?>"><?php echo $name; ?></a>
<?php } ?>