【WordPress】カスタムタクソノミーのリンクと公開記事数をリスト表示

2024年9月30日2024年10月6日

読みたい箇所へ移動する

はじめに

WordPressサイトを制作していると、、「カスタムタクソノミー」を使用することがよくあります。これにより、投稿を分類する独自のカテゴリやタグのようなものを作成できます。
そして、時にはそのタクソノミーに関連する「ターム」（タグ）をリスト表示し、それぞれに紐づく公開記事の数を一緒に表示したいとクライアントからご要望をいただくことがあります。

今回は、特定のカスタムタクソノミーに関連するタームリンクと、各タームに紐づいた公開記事数を表示するコードを記載します。

タームリンクリスト表示の実装

サンプルコード

  <?php
  /**
   * カスタムタクソノミーのターム一覧を表示し、ターム名の後ろに投稿数を表示
   * XXXXはカスタムタクソノミーのスラッグ
   */

  // 指定されたタクソノミーのすべてのタームを取得
  $terms = get_terms([
    'taxonomy'   => 'XXXX', // カスタムタクソノミーのスラッグ
    'hide_empty' => true, // 投稿がないタームは非表示
  ]);

  if (!empty($terms) && !is_wp_error($terms)) : ?>
    <ul class="tag_list">
      <?php foreach ($terms as $term) :
          // タームのリンクを取得
          $term_link = get_term_link($term);

          // リンク取得にエラーがある場合、このタームをスキップ
          if (is_wp_error($term_link)) {
            continue;
          }
        ?>
      <li class="tag_item">
        <a class="tag_link" href="<?php echo esc_url($term_link); ?>">
          <?php echo esc_html($term->name); ?> (<?php echo esc_html($term->count); ?>)
        </a>
      </li>
      <?php endforeach; ?>
    </ul>
  <?php endif; ?>

コードの詳細説明

// 'XXXX' タクソノミーのすべてのタームを取得
$terms = get_terms([
  'taxonomy'   => 'XXXX',  // 取得するタクソノミーを指定
  'hide_empty' => true,    // 投稿がないタームは非表示
]);

get_terms()：指定されたカスタムタクソノミーのタームを取得します。
taxonomy：タクソノミーのスラッグを指定。
hide_empty：投稿がないタームを非表示にします。

if (!empty($terms) && !is_wp_error($terms)) : ?>
  <ul class="tag_list">
    <?php foreach ($terms as $term) :
      $term_link = get_term_link($term);
      if (is_wp_error($term_link)) {
        continue;
      }
    ?>
    <li class="tag_item">
      <a class="tag_link" href="<?php echo esc_url($term_link); ?>">
        <?php echo esc_html($term->name); ?> (<?php echo esc_html($term->count); ?>)
      </a>
    </li>
    <?php endforeach; ?>
  </ul>
<?php endif; ?>