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()
: 投稿に関連付けられたタームをリンク付きで表示するための関数です。