get_term_link()

get_term_link() 関数の概要

get_term_link()関数は、WordPressのデータベースから特定のターム(用語)のURLを取得するための関数です。この関数を使用することで、指定したタームIDやスラッグに基づいて、そのタームのアーカイブページへのリンクを取得することができます。カテゴリ、タグ、カスタムタクソノミーなど、さまざまなタームのリンクを生成する際に便利です。

パラメータの説明

get_term_link()関数には、以下のパラメータを設定することができます:

  • $term (int|string|object) – 必須: 取得したいタームのID、スラッグ、またはタームオブジェクトを指定します。
  • $taxonomy (string) – オプション: タームのタクソノミーの名前を指定します。省略した場合、タームオブジェクトからタクソノミーが取得されます。

使用例

以下は、get_term_link()関数を使用して特定のタームのリンクを取得し、表示する例です:

<?php
$term_id = 123; // 取得したいタームのID
$taxonomy = 'category'; // タクソノミーの名前
$term_link = get_term_link($term_id, $taxonomy);

if (!is_wp_error($term_link)) {
    echo 'タームリンク: <a href="' . esc_url($term_link) . '">こちら</a>';
} else {
    echo 'タームリンクの取得に失敗しました。';
}
?>

この例では、IDが123のタームのリンクを ‘category’ タクソノミーから取得し、リンクをHTML形式で表示しています。

関連する関数

  • get_term(): 特定のターム情報を取得するための関数です。
  • get_terms(): 特定のタクソノミー内のターム一覧を取得するための関数です。
  • get_the_terms(): 投稿に関連付けられたターム情報を取得するための関数です。
  • the_terms(): 投稿に関連付けられたタームをリンク付きで表示するための関数です。