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

描述
wp_get_recent_posts
英文解釋很短，就不貼了，
中文大概意思是：獲取最新文章的函數(shù)。
實(shí)際上這是一個(gè) get_posts函數(shù)的再使用。
描述的再好也木用，下面看使用。

使用/用法

 <?php 
  wp_get_recent_posts( $args ) 
 ?>

參數(shù)默認(rèn)值

 <?php $args = array(
//獲取的文章數(shù)量
  'numberposts' => 10,
//從第幾篇開始獲取
  'offset' => 0,
//分類的ID，如果不設(shè)置則顯示全部分類
  'category' => 0,
//排序規(guī)則 （注1，下詳）
  'orderby' => 'post_date',
//升、降序排列
  'order' => 'DESC',
//包括的文章ID
  'include' => ,
//排除的文章ID
  'exclude' => ,
//自定義字段名稱
  'meta_key' => ,
//自定義字段的值，配合上一個(gè)參數(shù)，來選擇顯示符合自定義字段數(shù)值的文章。
  'meta_value' =>,
//文章類型：文章或頁面
  'post_type' => 'post',
//文章狀態(tài)：草稿、已發(fā)布、隱藏文章等....
  'post_status' => 'draft, publish, future, pending, private',
//這個(gè)木研究
  'suppress_filters' => true ); 
?>

實(shí)例
因?yàn)楦?get_posts 的使用方法實(shí)在是很相似，
所以就不給什么高深的例子了，簡單的給一個(gè)官方的例子。

<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>

總結(jié)
注意：因?yàn)閣p_get_recent_posts函數(shù)的返回值是一個(gè)數(shù)組，
setup_postdata 函數(shù)理論上只能接受對象類型的變量，
所以按照官方文檔的解釋是不能使用setup_postdata函數(shù)，裝載到循環(huán)中使用的。
因?yàn)橛玫牟欢?，所以我也就沒有去試，有興趣的同學(xué)可以試一試看能否成功。
所以說，如果使用 setup_postdata 函數(shù)的話，
wp_get_recent_posts 函數(shù)不如 get_posts 函數(shù)使用起來方便。

注：
‘a(chǎn)uthor' —— 按作者數(shù)值編號排序
‘category' —— 按類別數(shù)值編號排序
‘content' —— 按內(nèi)容排序
‘date' —— 按創(chuàng)建日期排序
‘ID' —— 按文章編號排序
‘menu_order' —— 按菜單順序排序。僅頁面可用。
‘mime_type' —— 按MIME類型排序。僅附件可用。
‘modified' —— 按最后修改時(shí)間排序。
‘name' —— 按存根排序。
‘parent' —— 按父級ID排序
‘password' —— 按密碼排序
‘rand' —— 任意排序結(jié)果
‘status' —— 按狀態(tài)排序
‘title' —— 按標(biāo)題排序
‘type' —— 按類型排序

最新評論