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

説明

基本構文

get_category_link( int|WP_Term|object $category ): string

引数

• $category：カテゴリーIDまたはオブジェクト

戻り値

カテゴリーのURL。

使い方（サンプル）

echo esc_url( get_category_link( 5 ) );

注意点

• カテゴリーIDが存在しないと空文字が返ることがあります。
• カスタムタクソノミーには get_term_link() を使います。

実務での使いどころ

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

よくあるミスと対処

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

NG例

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

OK例

$cat = get_category_by_slug( 'news' );
if ( $cat ) {
	echo esc_url( get_category_link( $cat->term_id ) );
}

使い分け早見表

関連項目

get_term_link()、get_tag_link()

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