説明
object wp_count_posts( [ string $type = '' [ , string $perm = '' ] ] )
投稿数を取得する。
パラメータ
- $type投稿タイプを指定(省略時は'post')
- $perm'readable'または''を指定(省略時は'')
返り値
投稿ステータス別の投稿数を格納したオブジェクトを返す。オブジェクトのプロパティは次に示す通り投稿ステータス名であり、それぞれに投稿数が格納されている。| プロパティ | 内容 |
|---|---|
| publish | 公開 |
| future | 予約投稿 |
| draft | 下書き |
| pending | レビュー待ち |
| private | 非公開 |
| trash | ごみ箱 |
| auto-draft | 自動下書き |
| inherit | 継承記事(リビジョンなど) |
注意
パラメータ$permで'readable'を指定し、ユーザがログイン中( is_user_logged_in関数で調べる)でかつ他人のステータスが'private'な記事を閲覧できない( current_user_can関数で調べる)場合、検索対象はステータスが'private'以外か、そのユーザが投稿したステータスが'private'の投稿になる。使用例
- 投稿記事の投稿数を取得する。<?php $counts = wp_count_posts(); ?>
- カスタム投稿タイプ'news'で'readable'して投稿数を取得する。<?php $counts = wp_count_posts( 'news', 'readable' ); ?>
フィルター
投稿数を返す直前に'wp_count_posts'フィルターを呼び出す(3.7.0以降)。$countsには投稿数の連想配列が、$typeと$permのそれぞれにはパラメータで受け取った値が格納される。return apply_filters( 'wp_count_posts', $counts, $type, $perm );アクション
実行するアクションはありません。ソースファイル
/wp-includes/post.php最終更新 : 2013年10月31日 13:55
関連
お勧め
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つで、新規投稿時の本文ブロックのプレースホルダーテキストを変更するものだ。