wp_get_recent_posts

（1.0.0以降）
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

関連

参考

Code Reference: wp_get_recent_posts

お勧め

query_posts（WP_Queryクラス）で投稿タグを絞り込む（2011年9月14日 更新）

投稿タグの絞り込みは、カテゴリーに似ているけど微妙に違っている。今日は、昨日投稿した「query_posts（WP_Queryクラス）でカテゴリーを絞り込む」の続きとして、投稿タグの絞り込みついてまとめてみる。

管理者ページに文言を表示する（2012年4月19日 更新）

お客様向けに管理者ページをカスタマイズする機会が増えてきている。カスタマイズするページや表示場所、表示内容によっていくつかの手段があるが、今回はページの冒頭部分に任意の文言を表示する方法を紹介する。

oEmbedについて考えてみた（2018年5月27日 更新）

本サイト向けにテーマをリニューアルしようと思い一から作っている最中、ふと生成されているHTMLの中にあるoEmbedの記述が目についた。「この記述いつからだっけ」くらいに思いながらリンク先を開き、ちょっとモヤモヤしてしまった。

ショートコードを含んだページを表示する前に何か処理する（2014年5月28日 更新）

固定ページまたは投稿ページに独自のフォームを埋め込む。入力→登録の2段階のフォームなら著名なプラグイン「Contact Form 7」を利用すればいいのだが、クライアントの依頼は入力→確認→登録の3段階で組み込む要素が特化していたので、独自の実装方法を考えることになった。

WP_Postオブジェクトで投稿情報を直感的に使う（2012年10月4日 更新）

WordPress 3.5で登場するであろう WP_Postクラス。WordPressの投稿情報は、投稿情報本体のほか、カテゴリーや投稿タグ、カスタムフィールドなど、いくつかに分散して記録され、それぞれの情報を取得する際は、いくつかの関数をしていた。新しいWP_Postクラスにより、その習慣とおさらばできるかもしれない。