HOME  /WordPress関数
 /関数:get_the_category()
2020年02月25日

関数:get_the_category()

WordPressの関数説明は、一般的な使い方だけです。

詳細はWordPress Codexを参照してください。

説明

get_the_category()は、投稿のカテゴリ情報を抽出する関数です。

使い方

<?php get_the_category( $id ); ?>

 

<引数>

$id:投稿 ID(オプション)

省略時は現在の投稿IDになります。

 

<戻り値>(戻り値は配列です) 

この配列の主要な変数名は下記になります。

■term_id:(整数) カテゴリー ID

name:(文字列) カテゴリー名

■slug(文字列) カテゴリーのスラッグ名

 

備考

下記の様な形で使います。

<?php
 $category = get_the_category();
 $cat_id   = $category[0] -> term_id;
 $cat_name = $category[0] -> name;
 $cat_slug = $category[0] -> slug;
?>

推奨はスラッグです。このスラッグはURLの中にも表示されるのでチェックが簡単です。

これで取り出すと、下図のスラッグ名で取り出せます。

一般的な使い方は下記になります。

<?php $cat_slug = get_the_category()[0] -> slug; ?>

上記は「$cat_slug」に、現在の投稿のカテゴリのスラッグ名を取り出しています。

 

このサイトで、この関数を使っている所

投稿ページの下に関連記事一覧を表示させています。

この時、現在のドキュメントと同じカテゴリの記事を抽出して表示させています。