本記事では、WordPressでページ(記事)に設定しているカテゴリーやタグなどのターム情報を取得する方法について解説しています。
WordPressの学習におすすめ書籍
1冊ですべて身につくWordPress入門講座
メリット
- サイト運営に必須のことが学べる
- 基本的な使い方～オリジナルテーマ開発まで学べる
ポチップ
先輩くんAmazon Kindle Unlimitedに登録すると、月額980円で読み放題だからオススメだよ！
後輩ちゃん初回30日間は無料だから、まだ登録したことのない人はぜひ試してみてね！
全プログラマー必見！
変数名/関数名にもう悩まない！
変数名/関数名にもう悩まない！
リーダブルコード
メリット
- 美しいコードが書けるが自然と書けるようになる
- 他の開発者が理解しやすいコードになる
著:Dustin Boswell, 著:Trevor Foucher, 解説:須藤 功平, 翻訳:角 征典
¥2,640 （2023/07/23 02:48時点 | Amazon調べ）
ポチップ
目次
get_the_terms関数の使い方
ページに設定しているカテゴリーやタグなどのターム情報を取得するには、get_the_terms関数を使います。基本的な使い方は以下のとおりです。
<?php get_the_terms( $id, $taxonomy ); ?>引数の詳細
- $id(必須)：投稿IDを指定します。
- $taxonomy(必須)：取得するタームが属するタクソノミーを指定します。
戻り値
指定したタクソノミーに属するタームが存在した場合は、ターム情報をオブジェクトの配列を返します。タームが存在しない場合はfalseを返します。無効なタクソノミーが指定された場合は、WP_Errorオブジェクトを返します。
指定したタクソノミーに属するタームが存在した場合に返されるオブジェクトの配列の詳細は以下のとおりです。
stdClass Object
(
[term_id] =>
[name] =>
[slug] =>
[term_group] =>
[term_order] =>
[term_taxonomy_id] =>
[taxonomy] =>
[description] =>
[parent] =>
[count] =>
[object_id] =>
)get_the_terms関数のサンプルコード
実際に、get_the_terms関数を使用してカテゴリーのターム情報を取得するサンプルコードを用意したのでご参考にしてください。
<?php if (have_posts()) : ?>
<?php while (have_posts()) : the_post(); ?>
<?php $terms = get_the_terms(get_the_ID(), 'category') ?>
<?php if ($terms && !is_wp_error($terms)) : ?>
<?php foreach ($terms as $term) : ?>
<span class="category"><?php echo $term->name; ?></span>
<?php endforeach; ?>
<?php endif; ?>
<?php endwhile; ?>
<?php endif; ?>
