> WordPress开发手册 > get_posts

get_posts


get_posts 函数,简单的来讲是 get_post 的复数新形势,但因为是文章多篇提取,所以使用方法上却略有不同,支持众多参数选择需要提取的文章,在 CMS 主题中经常被用到,当然如果你对 WordPress 有更深了解的话,你也有可能是用 WP_Query 来替代该函数,这就是后话了,今天主要介绍一下 get_posts 函数。

get_posts 函数详解

该函数属于 WordPress  的内置函数,用于在 WordPress 中提取多篇指定或随机文章。
越是描述简单的函数,使用起来就越是复杂,后面的需要仔细看咯!

使用方法

$args=array(
	'numberposts'=>5,
	'offset'=>0,
	'category'=>,
	'orderby'=>'post_date',
	'order'=>'DESC',
	'include'=>,
	'exclude'=>,
	'meta_key'=>,
	'meta_value'=>,
	'post_type'=>'post',
	'post_mime_type'=>,
	'post_parent'=>,
	'post_status'=>'publish'
);
$posts_array=get_posts($args);

$args是该函数必要的变量
get_posts( $args )将返回数组型的变量。

变量参数详解

$args=array(
	//需要提取的文章数
	'numberposts'=>10,
	//以第几篇文章为起始位置
	'offset'=>0,
	//分类的ID,多个用逗号将分类编号隔开,或传递编号数组,可指定多个分类编号。
	//大部分CMS使用该函数的重点。
	'category'=>,
	//排序规则(注1)
	'orderby'=>'post_date',
	//升序、降序'ASC'——升序(低到高)'DESC'——降序(高到底)
	'order'=>'DESC',
	//要显示文章的ID
	'include'=>,
	//要排除文章的ID
	'exclude'=>,
	//自定义字段名称
	'meta_key'=>,
	//自定义字段的值,配合上一个参数,来选择显示符合自定义字段数值的文章。
	'meta_value'=>,
	//post(日志)——默认,page(页面),
	//attachment(附件),any——(所有)
	'post_type'=>'post',
	//文章的mime类型
	'post_mime_type'=>,
	//要显示文章的父级ID
	'post_parent'=>,
	//文章状态
	'post_status'=>'publish'
);
注1:
‘author’ —— 按作者数值编号排序
‘category’ —— 按类别数值编号排序
‘content’ —— 按内容排序
‘date’ —— 按创建日期排序
‘ID’ —— 按文章编号排序
‘menu_order’ —— 按菜单顺序排序。仅页面可用。
‘mime_type’ —— 按MIME类型排序。仅附件可用。
‘modified’ —— 按最后修改时间排序。
‘name’ —— 按存根排序。
‘parent’ —— 按父级ID排序
‘password’ —— 按密码排序
‘rand’ —— 任意排序结果
‘status’ —— 按状态排序
‘title’ —— 按标题排序
‘type’ —— 按类型排序

实例

刚我们讲到用数组去传参,当然我们也可以用字符串来给该函数传参,下面给一个简单的例子。

$posts_rand = get_posts('numberposts=3&orderby=rand');

以上代码用于随机在 WordPress 中获取3篇文章。


上一篇:
下一篇: