本文へ移動

用語集

WP_Query パラメーターcomment_count

`comment_count` は、コメント数を条件に投稿を絞り込みたい時に使うパラメーターです。

Huddly Huddly 投稿日: 2026年5月31日 更新日: 2026年8月29日 読了目安: 3分

まず結論

comment_count は、投稿についたコメント数を条件にして絞り込む WP_Query 引数です。WordPress 4.9 で追加されました。

コメントが多い順に並べる指定ではありません。件数で絞るのか、並び替えるのかを分けて考えます。

どういう時に使うか

たとえば「コメントが10件以上ある投稿だけ」を抽出したい時に使います。整数で一致件数を指定するほか、valuecompare の配列で比較条件を持たせられます。

コメント欄を閉じているサイトや、コメントを反応指標として使っていないサイトでは出番がありません。先に運用実態を確認します。

公開コメントだけを数える前提など、読者が想像する『コメント数』と実データの扱いが合っているかもテストデータで確かめます。

近い引数との違い

comment_count は取得対象を減らす条件です。一方、orderby => ‘comment_count’ は取得した投稿をコメント数順に並べます。

『10件以上を人気順にする』なら、絞り込みと並び順の両方が必要です。片方だけでは同じ結果になりません。

Builderでの扱い

現在の WP Query Builder には comment_count の直接入力欄がありません。必要な場合は生成後のコードへ手動で追加します。

Builder非対応であることを隠さず、比較演算子を含む入力UIを設計してから対応範囲を広げます。

使いどころ・避けどころと実践確認

コメント数が一定以上・以下の投稿を対象にする要件が明示されている時に使います。

コメントの承認状態や本文内容を調べたい場合、または人気順を作るだけの場合は別の設計が必要です。

コメントが無効な投稿やテストデータの偏りで0件になりやすいため、比較演算子と実データの分布を先に確認します。

コメント数を人気の代わりに使うと、コメントを受け付けない記事が不利になるため、指標の意味を先に確かめます。

コメント数が0、境界値、境界値超過の3投稿を用意し、valuecompare ごとに取得できた投稿IDを表に残します。

関連記事リンクのサムネイル

WordPressの仕様で確認するポイント

公式の WP_Query::parse_query() には、導入バージョンと受け付ける形が記録されています。

並び順との違いは WP_Query の Order & Orderby Parameters も合わせて確認します。

公式リンク

公式ドキュメント

最後は、値を変える目的と、変えた時に失う情報を一緒に確認します。

最後に確認したいこと

  • 絞り込みと並び替えを混同していない
  • 整数指定か value/compare 指定かを決めた
  • コメント機能を使うサイトか確認した
  • Builderでは手動追加になることを確認した

公式リファレンス

仕様や原文の説明も確認したいときは、公式ドキュメントと整理ページをあわせて見ると理解しやすくなります。

この記事の検証情報

検証環境

WordPress
7.1
PHP
8.3.33
テーマ
wpq-media + DDEV
対象
カスタム投稿 / taxonomy / meta_query

更新履歴

  • 2026年5月26日 glossary 用の初回ドラフトを作成
  • 2026年8月15日 公式資料を再確認し、用語集として本文と判断材料を再構成

この用語を活用する

あとで見返す・共有する

お気に入りに保存できます。役に立ったポイントは、いいねや共有で教えてください。

他の用語も続けて確認できます

似た用語や周辺知識をまとめて見たいときは、用語集トップから探すと迷いにくくなります。

用語集トップを見る