説明

パラメータ

• $args
  検索条件を指定する連想配列または文字列。文字列で複数のキーワードを指定する場合は'&'で連結する。主なキーワードは次の通り。

  キーワード	意味
  author_email	コメント投稿者メールアドレス（省略時は''）
  ID	コメントID（省略時は''）
  karma	カルマ（省略時は''）
  number	取得したいコメント数（省略時は''）
  offset	コメントの取得位置（省略時は''）
  orderby	並び順を示すフィールド名（複数指定する場合は,で区切る）
  order	並び順を示すキーワードとして'DESC'（降順）か'ASC'（昇順）を指定（省略時は'DESC'）
  parent	親コメントID（省略時は''）
  post_ID	投稿情報ID（省略時は''）
  post_id	投稿情報ID（省略時は0）
  status	'hold'、'approve'、'spam'、'trash'などのコメントステータス（省略時は''）
  type	'comment'、'pings'、'pingback'などのコメント種別（省略時は''）
  user_id	ユーザID（省略時は''）
  count	条件にマッチした件数を取得する場合はtrue、コメント情報そのものを取得する場合はfalse（省略時はfalse）
  search	コメント投稿者の名前、メールアドレス、URL、IPアドレスまたはコメント内容を部分一致するキーワード（省略時は''）
  post_author	コメント元投稿の投稿者名（省略時は''）
  post_name	コメント元投稿の投稿名（省略時は''、タイトルではない）
  post_parent	コメント元投稿の親投稿ID（省略時は''）
  post_status	'publish'、'private'などのコメント元投稿の投稿ステータス（省略時は''）
  post_type	'post'、'attackment'などのコメント元投稿の投稿タイプ（省略時は''）
  meta_key	検索・並び替えを行うコメントメタ情報のキー名（省略時は''）
  meta_value	検索するコメントメタ情報の値（省略時は''）
  meta_query	コメントメタ情報の検索条件を配列で指定（省略時は''）
  date_query	日時検索条件の配列を指定（省略時はnull）

返り値

使用例

• IDが10の投稿ページのコメント情報を5件分取得する（文字列指定）。
  <?php $comments = get_comments( 'post_id=10&number=5' ); ?>
• IDが10の投稿ページのコメント情報を5件分取得する（配列指定）。
  <?php $comments = get_comments( array( 'post_id' => 10, 'number' => 5 ) ); ?>

フィルター

アクション

ソースファイル

関連

• get_approved_comments - 投稿記事のコメント情報を取得する
• get_comment_count - コメント数を取得する

参考

• [WordPress]pre_get_commentsによるコメントの抽出・検索方法  |  Wood-Roots.blog
• サイドバーに新着コメントリストを表示する / かりんと～く 【 夢猫工房 】

お勧めコンテンツ