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" —— 按类型排序