wp_count_terms

説明

array | int | WP_Error wp_count_terms( array | string $args = array() [ , array | string $deprecated = '' ] )
タクソノミーのターム数を取得する。

パラメータ

バージョン5.6.0以降のパラメータは次の通り。

  • $args
    オプションを連想配列または文字列で指定(省略時はarray())。
  • $deprecated
    非推奨(省略時は'')。

バージョン5.5.3以前のパラメータは次の通り。

wp_count_terms( string $taxonomy [ , array | string $args = array() ] )
  • $taxonomy
    タクソノミー名を指定。
  • $args
    オプションを連想配列または文字列で指定(省略時はarray())。

返り値

タクソノミーのターム数を返す。無効なタクソノミーを指定した場合は WP_Errorオブジェクトを返す([5.6.0])

注意

パラメータ$argsには get_termsのオプションが指定できる('fields'は'count'固定)。

[5.6.0]パラメータの仕様が変わり、第1パラメータがオプションに、第2パラメータは非推奨に変更された。


使用例

  • 投稿タグのターム数を取得する。
    // 5.5.3以前
    $count = wp_count_terms( 'post_tag' );
    
    // 5.6.0以降
    $count = wp_count_terms( array( 'taxonomy' => 'post_tag' ) );
    

フィルター

直接実行するフィルターはありません。

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/taxonomy.php

最終更新 : 2020年12月14日 16:32



お勧め

meta_compare_key使ってみた(2019年3月19日 更新)

ブロックエディターの登場により、標準のカスタムフィールドを使う機会はかなり減った気がする。そんな中、5.1.0で追加されたのが、カスタムフィールド名(メタキー)に含まれる文字列を指定する'meta_compare_key'キーだ。

WP_List_Tableクラスの「一括操作」フォームを使ってみた(2018年5月27日 更新)

今回は「WP_List_Tableクラスを使ってみた」の続き。投稿一覧やプラグインページなどにある「一括操作」(Bulkアクション)フォーム対応に関するメモである。

テーマから投稿画像のサイズを指定する(2012年3月15日 更新)

投稿記事に挿入する画像サイズは、サムネイル(150×150)、中サイズ(300×300)、大サイズ(1024×1024)がデフォルトだが、テーマによっては別のサイズを指定したい場合はある。基本的には、「設定」-「メディア」の「メディア設定」ページで指定できるが、テーマ内のfunctions.phpで設定しておくとちょっと便利かもしれない。

ログインページを変える(2014年9月12日 更新)

WordPressの標準的な不正ログイン対策としては、ログインIDは'admin'を避けるパスワードはユニークで長くする、場合によってはアクセスできるIPアドレスを制限する、といった具合だろう。これらの他に何かできないものだろうかと、ちょっと考えてみた。

新規投稿時の本文プレースホルダーテキストを変える(2021年9月9日 更新)

ブロックエディターに影響を与えるフィルターは多数存在する。今回紹介するフィルターはその1つで、新規投稿時の本文ブロックのプレースホルダーテキストを変更するものだ。