説明
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
関連
お勧め
6.2に追加されるsearch_columnsパラメータが便利(2023年3月30日 更新)
バージョン6.2では記事検索機能を備えたWP_Queryクラスにsearch_columnsパラメータが追加される。標準のキーワード検索では、タイトル(post_title)、本文(post_content)、抜粋(post_excerpt)が対象になっているが、search_columnsパラメータを使うと対象を絞り込めるようになる。
固定ページのURLの拡張子をhtmlに変更する(2013年3月9日 更新)
固定ページについて、URLを静的ページっぽく拡張子htmlに変更したいという要望を受けることがある。これまでは「.html on PAGES」というプラグインを使っていて特に不満があったわけではないのだが、今回ひょんなことから簡単に対応できることがわかったので、メモ書きしておく。KUSANAGIでマルチサイト(サブドメイン)を試した(2019年8月6日 更新)
本サイトはサブディレクトリタイプのマルチサイト機能を採用して構築しているが、これまでサブドメインタイプは利用した経験はない。マルチサイト機能のサブドメインタイプは以前から1度は試してみたいと思っており、今回実際にサイトを構築してみた。
Fotepo:プラグイン作ってみました(2019年9月19日 更新)
仕事柄、Chromeの「デベロッパーツール」を使ってページのフォントを変更することがある。そんな時、無効なフォント名を指定してしまったり、フォント名をまちがえることがあり、もう少しお手軽にできないかと思って作ったのが今回紹介するプラグイン「Fotepo」である。
カテゴリー専用の投稿一覧と新規投稿メニューを追加する(2012年1月23日 更新)
サイト更新の1クリックを省くため、特定カテゴリーの投稿に対して同じようにメニューを追加してみた。カスタム投稿タイプの専用投稿メニューみたいな感じである。