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

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

基本構文

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

get_the_tags($post);

get_the_tags($post);

引数

実行結果

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

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

例１．記事が所属するタグの名前を表示

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

<?php
$tags = get_the_tags();
    foreach ($tags as $tag) { // 配列からカテゴリーオブジェクトを１つ１つ取り出して処理
  	echo $tag->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
			$tags = get_the_tags();
			if (!empty($tags) && !is_wp_error($tags)) {
				echo '<div class="article__category">';
				foreach ($tags as $tag) {
					echo '<span>' . $tag->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
			$tags = get_the_tags();
			if (!empty($tags) && !is_wp_error($tags)) {
				echo '<div class="article__category">';
				foreach ($tags as $tag) {
					echo '<span>' . $tag->name . '</span>';
				}
				echo '</div>';
			}
			?>
		<?php endwhile; ?>
	<?php endif; ?>
</div>

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