get_tag_link() の使い方｜説明・引数・注意点

説明

基本構文

get_tag_link( int|WP_Term|object $tag ): string

引数

• $tag：タグIDまたはオブジェクト

戻り値

タグのURL。

使い方（サンプル）

echo esc_url( get_tag_link( 8 ) );

注意点

• 存在しないタグでは空文字が返ります。

実務での使いどころ

• タグのアーカイブページへの、リンクを作るとき。
• get_the_tags() で取得したタグを、リンク付きで出力するとき。

よくあるミスと対処

• スラッグやタグ名を渡している。引数は、タグのIDまたはオブジェクト。
• 存在しないタグでは、空文字が返る。確認せずに出力する。
• 出力時に、esc_url() を通していない。

NG例

echo get_tag_link( 'php' ); // スラッグでは取得できない

OK例

$tag = get_term_by( 'slug', 'php', 'post_tag' );
if ( $tag ) {
	echo esc_url( get_tag_link( $tag->term_id ) );
}

使い分け早見表

関連項目

get_category_link()、get_term_link()

公式リファレンス：get_tag_link() | Function | WordPress Developer Resources