【WordPress】記事の件数を取得・表示する方法｜wp_count_posts・カテゴリ別・カスタム投稿タイプ別まで完全解説

この記事で分かること

• wp_count_posts() で投稿・固定ページ・カスタム投稿の件数を取得する方法
• カテゴリ別・タグ別の記事件数を取得する方法
• 著者（ユーザー）別の投稿数を取得する方法
• WP_Queryの found_posts で検索結果の件数を取得する方法
• 記事数をショートコード化してエディタから表示する方法
• ステータス別（下書き・予約投稿・レビュー待ち）のカウント方法

PHP — 公開済み投稿の件数を表示

<?php
$count_posts = wp_count_posts();
$published   = $count_posts->publish;
echo '記事数: ' . $published;
?>

▼ 出力例

PHP — ステータス別に件数を表示

<?php
$count = wp_count_posts();

echo '公開済み: '    . $count->publish . '<br>';
echo '下書き: '      . $count->draft   . '<br>';
echo 'レビュー待ち: ' . $count->pending . '<br>';
echo '予約投稿: '    . $count->future  . '<br>';
?>

PHP — 固定ページの件数

<?php
// 第1引数に投稿タイプを指定
$count_pages = wp_count_posts( 'page' );
echo '固定ページ数: ' . $count_pages->publish;
?>

PHP — カスタム投稿タイプの件数

<?php
// カスタム投稿タイプ 'news' の公開件数
$count_news = wp_count_posts( 'news' );
echo 'ニュース記事数: ' . $count_news->publish;

// 投稿 + 固定ページ + カスタム投稿の合計
$total = wp_count_posts()->publish
       + wp_count_posts( 'page' )->publish
       + wp_count_posts( 'news' )->publish;
echo '全コンテンツ数: ' . $total;
?>

PHP — カテゴリIDから件数を取得

<?php
// カテゴリIDを指定して件数を取得
$category = get_category( 5 ); // カテゴリID: 5
echo $category->name . ': ' . $category->count . '件';
?>

PHP — カテゴリ一覧 + 件数表示

<?php
$categories = get_categories( array(
    'hide_empty' => true, // 記事がないカテゴリは除外
) );

foreach ( $categories as $cat ) {
    echo '<li>' . $cat->name . ' (' . $cat->count . '件)</li>';
}
?>

PHP — タグ別の件数を取得

<?php
// タグスラッグで件数を取得
$tag = get_term_by( 'slug', 'php', 'post_tag' );
if ( $tag ) {
    echo $tag->name . ': ' . $tag->count . '件';
}

// 現在のアーカイブページのターム件数
$term = get_queried_object();
echo $term->name . ': ' . $term->count . '件';
?>

PHP — カスタムタクソノミーの件数を取得

<?php
// カスタムタクソノミー 'difficulty' の特定タームの件数
$term = get_term_by( 'slug', 'beginner', 'difficulty' );
if ( $term ) {
    echo $term->name . ': ' . $term->count . '件';
}

// カスタムタクソノミーの全ターム一覧と件数
$terms = get_terms( array(
    'taxonomy'   => 'difficulty',
    'hide_empty' => true,
) );

foreach ( $terms as $t ) {
    echo '<li>' . $t->name . ' (' . $t->count . '件)</li>';
}
?>

get_terms() のポイント

get_terms()はカテゴリ・タグ・カスタムタクソノミーすべてに使える汎用的な関数です。taxonomy引数にタクソノミー名を指定し、hide_emptyで空のタームを除外できます。
WordPress 4.5以降は配列形式の引数が推奨されています。

PHP — 著者別の投稿数

<?php
// ユーザーIDを指定して投稿数を取得
$user_post_count = count_user_posts( 1 ); // ユーザーID: 1
echo '投稿数: ' . $user_post_count;

// カスタム投稿タイプを指定する場合
$news_count = count_user_posts( 1, 'news' );

// 現在のログインユーザーの投稿数
$current_user = get_current_user_id();
$my_count     = count_user_posts( $current_user );
?>

PHP — WP_Query で条件付き件数を取得

<?php
$query = new WP_Query( array(
    'post_type'      => 'post',
    'category_name'  => 'wordpress',
    'posts_per_page' => 1,  // 件数だけ知りたい場合は1でOK
) );

echo '検索結果: ' . $query->found_posts . '件';

wp_reset_postdata();
?>

found_posts と post_count の違い

found_postsは条件に一致する全件数（ページネーション前の総数）を返します。
post_countは現在のページの件数（posts_per_pageで制限された数）を返します。
WP_Queryの詳しい使い方は「WP_Queryで複雑な条件検索を実装する方法」で解説しています。

PHP — アーカイブページ・検索結果の件数

<?php
global $wp_query;

// 検索結果ページで「〇件見つかりました」と表示
if ( is_search() ) {
    echo '「' . get_search_query() . '」の検索結果: '
       . $wp_query->found_posts . '件';
}

// カテゴリアーカイブで件数を表示
if ( is_category() ) {
    echo single_cat_title( '', false )
       . ': ' . $wp_query->found_posts . '件';
}
?>

functions.php — 記事数表示ショートコード

// [post_count] で公開記事数を表示
// [post_count type="page"] で固定ページ数
// [post_count type="news"] でカスタム投稿数
// [post_count category="wordpress"] でカテゴリ別件数
// [post_count status="draft"] で下書き件数
function codingls_post_count_shortcode( $atts ) {
    $atts = shortcode_atts( array(
        'type'     => 'post',
        'category' => '',
        'status'   => 'publish',
    ), $atts );

    // カテゴリ指定がある場合は WP_Query で取得
    if ( ! empty( $atts['category'] ) ) {
        $q = new WP_Query( array(
            'post_type'      => $atts['type'],
            'category_name'  => $atts['category'],
            'post_status'    => $atts['status'],
            'posts_per_page' => 1,
        ) );
        $result = $q->found_posts;
        wp_reset_postdata();
        return $result;
    }

    $count = wp_count_posts( $atts['type'] );
    $status = $atts['status'];
    return isset( $count->$status ) ? $count->$status : 0;
}
add_shortcode( 'post_count', 'codingls_post_count_shortcode' );

▼ エディタでの使用例

JavaScript — REST API で件数を取得

// REST API のレスポンスヘッダーから件数を取得
const response = await fetch(
  '/wp-json/wp/v2/posts?per_page=1'
);

// X-WP-Total: 全記事数
const totalPosts = response.headers.get( 'X-WP-Total' );

// X-WP-TotalPages: 総ページ数
const totalPages = response.headers.get( 'X-WP-TotalPages' );

console.log( '記事数:', totalPosts );
console.log( 'ページ数:', totalPages );

wp_count_posts() vs WP_Query の使い分け

wp_count_posts()は内部的にキャッシュされるため、同一リクエスト内で何度呼び出しても追加のSQLは発行されません。単純なステータス別カウントにはこちらを使いましょう。

WP_Queryは複雑な条件指定が可能ですが、その分SQLが重くなります。件数だけ知りたい場合はposts_per_page => 1を指定し、実データの取得を最小限にするのがコツです。

サイドバーなどで件数を頻繁に表示する場合は、Transient APIでキャッシュすると負荷を軽減できます。

PHP — Transient API で件数をキャッシュする例

<?php
$count = get_transient( 'site_post_count' );

if ( $count === false ) {
    // キャッシュがなければ取得して1時間キャッシュ
    $count = wp_count_posts()->publish;
    set_transient( 'site_post_count', $count, HOUR_IN_SECONDS );
}

echo '記事数: ' . $count;
?>

functions.php — 記事の保存時にキャッシュをクリア

// 記事の公開・更新時に件数キャッシュを削除
function codingls_clear_post_count_cache( $post_id ) {
    // 自動保存はスキップ
    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
        return;
    }
    delete_transient( 'site_post_count' );
}
add_action( 'save_post', 'codingls_clear_post_count_cache' );

WordPress 記事件数取得のポイント