WordPress開發中用於獲取近期文章的PHP函數使用解析

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' —— 按類型排序