WordPress获取文章标签：get_posts

WordPress模板标签get_posts用于获取文章信息，通常用于输出最新文章列表、随机文章、指定分类文章等等，在用WordPress制作CMS网站时非常有用。

get_posts( array $args = null )

函数参数

$args

数组或字符串值

get_posts()函数$args参数默认的值如下：

$defaults = array('numberposts' => 5,'category' => 0,'orderby' => 'date','order' => 'DESC','include' => array(),'exclude' => array(),'meta_key' => '','meta_value' => '','post_type' => 'post','suppress_filters' => true);

get_posts()函数$args参数可用的值如下：

orderby

字符串值，默认值：date

设置排序的类型。

none：不使用排序；
ID：按ID排序；
author：按作者排序；
title：按标题排序；
date：按日期排序；
modified：按文章的修改日期排序；
parent：按父级文章ID排序；
rand：随机顺序；
comment_count：按评论数量排序；
menu_order：如果页面，有一个排序设置项，则按这个设置排序；
meta_value：按元数据排序；
meta_value_num：按元数据排序；
post__in：按照传递参数的顺序。

numberposts

整数型，默认值：5

指定输出文章的数量。

category

整数型，默认值：0

指定分类的ID，输出该分类下的文章，默认所有分类。

order

字符串值，默认值：DESC

指定排序的方式。

DESC：降序；
ASC：升序。

include

字符串或数组，默认为空

指定文章的ID，以输出这些文章的信息。

exclude

字符串或数组，默认为空

指定文章的ID，以排除这些文章。

meta_key

字符串值，默认为空

自定义字段的名称。

meta_value

字符串值，默认为空

自定义字段的值。

post_type

字符串值，默认值：post

文章类型。

post：文章；
page：页面；
revision：文章的修订版本；
attachment：附件；
自定义文章类型。

suppress_filters

布尔值，默认值：true

是否使用过滤器。

函数使用示例

输出5篇分类1的文章

<ul><?phpglobal $post;$args = array( 'numberposts' => 5, 'category' => 1 );$myposts = get_posts( $args );foreach ( $myposts as $post ) : setup_postdata( $post );?><li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li><?phpendforeach;wp_reset_postdata();?></ul>

扩展阅读

get_posts()函数位于：wp-includes/post.php