ワードプレスのget_category_link関数の使用方法・解説

概要

get_category_link 関数は、指定したカテゴリーのリンク文字列を取得するために使用されます。主に以下のような機能を実装する際に役立ちます。

1. カテゴリーアーカイブページへのリンクを生成
2. カテゴリーページのナビゲーション表示
3. カテゴリーアイコンやタイトル表示の際にリンクを整形
4. カテゴリーフィルター機能を実装する際のリンク作成
5. カスタムウィジェットでカテゴリーリンクを表示
6. カテゴリーセクションが存在するカスタムテンプレートでの使用
7. SEOに配慮したURL生成
8. カテゴリーに属する投稿のリンクを動的に作成

構文

get_category_link( $category_id );

パラメータ

• $category_id (int) (必須): 取得したいカテゴリーのID。

戻り値

• (string): カテゴリーのリンクURL。

関連する関数

• get_category
• get_categories

使用可能なバージョン

この関数はWordPress 2.1以降で使用可能です。

コアファイルのパス

wp-includes/category.php

サンプルコード

1. 基本的なカテゴリーリンクの取得

   $link = get_category_link( 3 );
   echo '<a href="' . esc_url( $link ) . '">カテゴリーリンク</a>';
   

   このコードは、IDが3のカテゴリーのリンクを取得し、それを表示するためのHTMLリンクを生成します。

2. ループ内でのカテゴリーリンクの生成

   $categories = get_the_category();
   foreach ( $categories as $category ) {
      echo '<a href="' . esc_url( get_category_link( $category->term_id ) ) . '">' . esc_html( $category->name ) . '</a>';
   }
   

   投稿のカテゴリーをループで回し、各カテゴリーのリンクを生成します。

3. 特定のカテゴリーのリンクをフィルタリング

   $category_id = 5; // 特定のカテゴリーID
   if ( get_category_link( $category_id ) ) {
      echo 'このカテゴリーのリンクは: ' . esc_url( get_category_link( $category_id ) );
   }
   

   特定のカテゴリーのリンクが存在するかを確認し、存在する場合のみ表示します。

4. カスタムメニューにカテゴリーリンクを追加

   $menu_items = wp_get_nav_menu_items( 'primary' );
   foreach ( $menu_items as $item ) {
      if ( $item->type === 'taxonomy' && $item->object === 'category' ) {
          echo '<li><a href="' . esc_url( get_category_link( $item->object_id ) ) . '">' . esc_html( $item->title ) . '</a></li>';
      }
   }
   

   カスタムメニューに含まれるカテゴリーのリンクを取得し、リスト形式で表示します。

5. カテゴリーをリスト表示してリンクを生成

   $categories = get_categories();
   echo '<ul>';
   foreach ( $categories as $category ) {
      echo '<li><a href="' . esc_url( get_category_link( $category->term_id ) ) . '">' . esc_html( $category->name ) . '</a></li>';
   }
   echo '</ul>';
   

   すべてのカテゴリーを取得し、そのリンクをリスト形式で表示します。

この関数のアクションでの使用可能性

アクション名	使用可能性
mu_plugin_loaded
registered_post_type
plugins_loaded
wp_roles_init
setup_theme
after_setup_theme
set_current_user
init
register_sidebar
wp_loaded
send_headers
parse_query
pre_get_posts
wp
template_redirect
get_header
wp_head

この関数は特定のワードプレスバージョンで非推奨または削除されていないため、そのような情報は存在しません。