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>
<?php
	global $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>
<?php
	endforeach;
	wp_reset_postdata();
?>
</ul>

扩展阅读

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

相关函数:

阿里云