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>RecentPosts</h2> <ul> <?php //获取最新文章 $recent_posts=wp_get_recent_posts(); //遍历出每一篇文章。 foreach($recent_postsas$recent){ echo'<li><ahref="'.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'——按类型排序