WEB制作のための情報サイト / unazuki Library

基本構文と使い方（引数・実行結果）

基本構文

投稿に紐づいているカテゴリー情報を取得します。記事個別ページ（single.php）で投稿が所属するカテゴリー情報を表示するときや、記事一覧ページ（archive.phpやcategory.phpなど）において、各記事の日付やタイトルと同時にカテゴリーも表示するときなどに使うことが多いです。

get_the_category($post_id);

get_the_category($post_id);

引数

実行結果

戻り値（返す値）：条件にマッチしたカテゴリーオブジェクトの配列
取得したカテゴリーオブジェクトを配列として返します。foreachでループを回して配列から１つ１つ要素（タームのオブジェクト）を取り出してタームの名前を取得したりすることができます。

get_the_category()はget_the_terms()のラッパー関数です。get_the_category()の内部でget_the_terms()を実行しています。内部でget_the_terms()を実行する際に、タクソノミーをcategory（投稿に標準実装されているカテゴリー）に自動的に指定しています。
このオブジェクトが持つ主なプロパティ（中身）は以下の通りです。

例１．記事が所属するカテゴリーの名前を表示

<?php
$terms = get_the_category();
    foreach ($terms as $term) { // 配列からカテゴリーオブジェクトを１つ１つ取り出して処理
  	echo $term->name; // カテゴリーオブジェクトからかてカテゴリー名を取得して表示
}
?>

<?php
$terms = get_the_category();
    foreach ($terms as $term) { // 配列からカテゴリーオブジェクトを１つ１つ取り出して処理
  	echo $term->name; // カテゴリーオブジェクトからかてカテゴリー名を取得して表示
}
?>

学習者向け補足情報

よくある使い方

記事個別ページ（single.php）で投稿が所属するカテゴリー情報を表示するときや、記事一覧ページ（archive.phpやcategory.phpなど）において、各記事の日付やタイトルと同時にカテゴリーも表示するときなどに使うことが多いです。具体的なコードは下記「参考コード」を参考にしてください。

参考コード

下記の例は、single.phpにて記事情報を表示する際に使える参考コードです。公開日の下に記事が所属するカテゴリー情報が表示されます。

<div class="article">
	<?php if (have_posts()) : ?>
		<?php while (have_posts()) : the_post(); ?>
			<div class="article__date">公開日：<?php echo get_the_date('') ?></div>
			<?php
			$categories = get_the_category();
			if (!empty($categories) && !is_wp_error($categories)) {
				echo '<div class="article__category">';
				foreach ($categories as $category) {
					echo '<span>' . $category->name . '</span>';
				}
				echo '</div>';
			}
			?>
		<?php endwhile; ?>
	<?php endif; ?>
</div>

<div class="article">
	<?php if (have_posts()) : ?>
		<?php while (have_posts()) : the_post(); ?>
			<div class="article__date">公開日：<?php echo get_the_date('') ?></div>
			<?php
			$categories = get_the_category();
			if (!empty($categories) && !is_wp_error($categories)) {
				echo '<div class="article__category">';
				foreach ($categories as $category) {
					echo '<span>' . $category->name . '</span>';
				}
				echo '</div>';
			}
			?>
		<?php endwhile; ?>
	<?php endif; ?>
</div>

関連するテンプレートタグ