get_the_terms() 関数の概要
get_the_terms()関数は、WordPressのデータベースから特定の投稿に関連付けられたターム（用語）を取得するための関数です。この関数を使用することで、指定した投稿IDに関連するターム情報を配列として取得することができます。カテゴリ、タグ、カスタムタクソノミーなど、さまざまなタームを取得する際に便利です。取得したターム情報には、タームID、名前、スラッグ、説明、親タームIDなどが含まれます。
パラメータの説明
get_the_terms()関数には、以下のパラメータを設定することができます：
$post(int|WP_Post) – 必須: タームを取得したい投稿のIDまたは投稿オブジェクトを指定します。$taxonomy(string) – 必須: タームが属するタクソノミーの名前を指定します。
使用例
以下は、get_the_terms()関数を使用して特定の投稿に関連付けられたタームを取得し、表示する例です：
<?php
$post_id = 123; // 取得したい投稿のID
$taxonomy = 'category'; // タクソノミーの名前
$terms = get_the_terms($post_id, $taxonomy);
if (!empty($terms) && !is_wp_error($terms)) {
foreach ($terms as $term) {
echo 'ターム名: ' . $term->name . '<br>';
echo 'タームスラッグ: ' . $term->slug . '<br>';
echo 'ターム説明: ' . $term->description . '<br>';
echo '親タームID: ' . $term->parent . '<br>';
echo '投稿数: ' . $term->count . '<br><br>';
}
} else {
echo 'この投稿にはタームがありません。';
}
?>この例では、IDが123の投稿に関連付けられたタームを ‘category’ タクソノミーから取得し、それぞれのタームの詳細を表示しています。
関連する関数
get_term(): 特定のターム情報を取得するための関数です。get_terms(): 特定のタクソノミー内のターム一覧を取得するための関数です。get_term_by(): 特定のフィールド値に基づいてターム情報を取得するための関数です。get_term_link(): 特定のタームのURLを取得するための関数です。
