wp_get_recent_posts

説明

mixed wp_get_recent_posts( [ mixed $args = array() [ , string $output = ARRAY_A ] ] )
最新の投稿情報を取得する。

パラメータ

  • $args
    検索条件を連想配列で指定(省略時はarray())。
    キーワード意味
    numberposts取得件数(省略時は10)
    offset取得開始位置(省略時は0:先頭)
    category何れかのカテゴリーに属する投稿情報はカテゴリーIDを、何れのカテゴリーにも属さない投稿情報は-を付けたカテゴリーIDを指定(複数指定する場合は,で区切る)
    orderbyソート対象を示すauthor、date、category、title、modified、ID、randなど(省略時は'post_date':投稿日時)
    orderソート順を示すASCかDESC(省略時はDESC)
    include取得したい投稿情報ID(複数指定する場合は,で区切る)
    exclude取得したくない投稿情報ID(複数指定する場合は,で区切る)
    meta_keyカスタムフィールドの名前
    meta_valueカスタムフィールドの値
    post_type'post'、'page'、'attachment'、'any'などの投稿情報タイプ(省略時は'post':投稿ページ)
    suppress_filters最終的な検索条件に対してフィルター処理を行わない場合はtrue、フィルター処理を行う場合はfalseを指定(省略時はtrue)
    post_status投稿ステータスを示す'auto-draft'、'draft'、'inherit'、'private'、'publish'、'any'など(省略時は'draft, publish, future, pending, private')
  • $output
    出力形式としてARRAY_AまたはOBJECTを指定(省略時はARRAY_A)。

返り値

パラメータ$outputがARRAY_Aの場合、条件にマッチした投稿情報を連想配列に変換した配列を返す。投稿情報がない場合は空の配列を返す。
パラメータ$outputがOBJECT(ARRAY_A以外)の場合、条件にマッチした投稿情報オブジェクトの配列を返す。投稿情報がない場合はfalseを返す。

注意

3.1以降とその前とで、パラメータの仕様が変わっている(3.1より前のバージョンでは、第1パラメータは取得したい投稿件数を指定していた)。
パラメータ$argsの内容は、内部で呼び出される get_posts関数に準じるが、省略時の値は異なっている。

使用例

  • 最新の投稿情報を5件取得する。
    <?php $recent = wp_get_recent_posts( array( 'numberposts' => 5 ) ); ?>
  • 最新の投稿情報をオブジェクトで取得する。。
    <?php $recent = wp_get_recent_posts( array(), OBJECT ); ?>

フィルター

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

アクション

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

ソースファイル

/wp-includes/post.php

最終更新 : 2013年10月16日 11:47



お勧め

パスとURL(2011年10月6日 更新)

テーマやプラグインで、WordPressシステム関連のディレクトリやURLを使う時があり、それらの多くは関数や定数として定義されている。今回は、それらの関数や定数について整理していく。

ブロックエディターの文字サイズ設定を変えてみる(2019年12月12日 更新)

今回は「前回投稿した内容」の続きブロックエディターの文字サイズ設定を変えようと思う。参考にするテーマはもちろん「Twenty Twenty」である。

5.5で非推奨になる関数名について(2020年8月12日 更新)

来月にリリースされるWordPress 5.5に向けてBeta 1、2と公開が続いている。「WordPress 5.5 Beta 2(以降Beta 2)」のソースコードを見ていくと、いくつかの関数が非推奨になるようだ。

KUSANAGIでマルチサイト(サブドメイン)を試した(2019年8月6日 更新)

本サイトはサブディレクトリタイプのマルチサイト機能を採用して構築しているが、これまでサブドメインタイプは利用した経験はない。マルチサイト機能のサブドメインタイプは以前から1度は試してみたいと思っており、今回実際にサイトを構築してみた。

LevelとCapability(2018年5月27日 更新)

プラグインやテーマの管理ページを作成する際など、ユーザのレベルと権限を確認することがある。ここでは、権限グループ別のレベルと権限の有無を整理してみた。