wp_get_recent_posts 函數在 WordPress 中是一個可以獲取近期文章數組的函數，相較于其他的文章獲取方式， wp_get_recent_posts 返回的將是一個數組而不是對象，所以在使用中對于一些新手或者是懶人，可能會更方便一些，下面我們就實例講解一下這個函數。

描述

wp_get_recent_posts

英文解釋很短，就不貼了，

中文大概意思是：獲取最新文章的函數。

實際上這是一個 get_posts函數的再使用。

描述的再好也木用，下面看使用。

使用/用法

<?php

wp_get_recent_posts( $args )

?>

參數默認值

<?php $args = array(

//獲取的文章數量

'numberposts' => 10,

//從第幾篇開始獲取

'offset' => 0,

//分類的ID，如果不設置則顯示全部分類

'category' => 0,

//排序規則 （注1，下詳）

'orderby' => 'post_date',

//升、降序排列

'order' => 'DESC',

//包括的文章ID

'include' => ,

//排除的文章ID

'exclude' => ,

//自定義字段名稱

'meta_key' => ,

//自定義字段的值，配合上一個參數，來選擇顯示符合自定義字段數值的文章。

'meta_value' =>,

//文章類型：文章或頁面

'post_type' => 'post',

//文章狀態：草稿、已發布、隱藏文章等....

'post_status' => 'draft, publish, future, pending, private',

//這個木研究

'suppress_filters' => true );

?>

實例

因為跟 get_posts 的使用方法實在是很相似，

所以就不給什么高深的例子了，簡單的給一個官方的例子。

<h2>Recent Posts</h2>

<ul>

<?php

//獲取最新文章

$recent_posts = wp_get_recent_posts();

//遍歷出每一篇文章。

foreach( $recent_posts as $recent ){

echo '<li><a href="' . get_permalink($recent["ID"]) . '" title="Look '.esc_attr($recent["post_title"]).'" >' . $recent["post_title"].'</a> </li> ';

}

?>

</ul>

總結

注意：因為wp_get_recent_posts函數的返回值是一個數組，

setup_postdata 函數理論上只能接受對象類型的變量，

所以按照官方文檔的解釋是不能使用setup_postdata函數，裝載到循環中使用的。

因為用的不多，所以我也就沒有去試，有興趣的同學可以試一試看能否成功。

所以說，如果使用 setup_postdata 函數的話，

wp_get_recent_posts 函數不如 get_posts 函數使用起來方便。

注：

‘author' —— 按作者數值編號排序

‘category' —— 按類別數值編號排序

‘content' —— 按內容排序

‘date' —— 按創建日期排序

‘ID' —— 按文章編號排序

‘menu_order' —— 按菜單順序排序。僅頁面可用。

‘mime_type' —— 按MIME類型排序。僅附件可用。

‘modified' —— 按最后修改時間排序。

‘name' —— 按存根排序。

‘parent' —— 按父級ID排序

‘password' —— 按密碼排序

‘rand' —— 任意排序結果

‘status' —— 按狀態排序

‘title' —— 按標題排序

‘type' —— 按類型排序

以上就是本文章的內容，希望對大家有所幫助。