wp_count_terms()


WordPressのwp_count_terms()関数は、指定されたタクソノミー内のタームの数を取得するために使用されます。この関数は、投稿数やカテゴリー、タグなどのターム数を計算する際に役立ちます。

構文

wp_count_terms( array|string $args = array() );

引数の説明:

  • $args (array|string) — タクソノミーや条件を指定するための引数。以下は主なサブキー:
    • taxonomy (string|array) — タクソノミーのスラッグ。
    • hide_empty (bool) — 投稿が関連付けられていないタームを非表示にする場合はtrue。
    • number (int) — 戻り値の最大ターム数。
    • name (string) — 特定のターム名。

例 1: タクソノミー内の全タームを数える

以下のコードは「category」タクソノミー内のターム数を取得します。

<?php echo wp_count_terms( array( 'taxonomy' => 'category' ) ); ?>

例 2: 投稿が関連付けられているタームのみをカウント

hide_emptyを使用して、関連付けられていないタームを除外します。

<?php echo wp_count_terms( array( 'taxonomy' => 'category', 'hide_empty' => true ) ); ?>

例 3: 特定のタクソノミー内で最大10個のタームをカウント

number引数を使用して制限します。

<?php echo wp_count_terms( array( 'taxonomy' => 'post_tag', 'number' => 10 ) ); ?>

例 4: 特定の名前を持つタームをカウント

特定の名前のターム数を取得します。

<?php echo wp_count_terms( array( 'taxonomy' => 'category', 'name' => 'ニュース' ) ); ?>

例 5: 複数のタクソノミーでタームをカウント

複数のタクソノミーを指定します。

<?php echo wp_count_terms( array( 'taxonomy' => array( 'category', 'post_tag' ) ) ); ?>

注意事項:

  • 引数が正しく設定されていない場合、エラーが発生する可能性があります。
  • hide_emptyがtrueの場合、非公開の投稿に関連付けられたタームはカウントされません。

関連機能：