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的文章
5, 'category' => 1 );
$myposts = get_posts( $args );
foreach ( $myposts as $post ) :
setup_postdata( $post );
?>
- <a href="">
扩展阅读
get_posts()函数位于:wp-includes/post.php
相关函数:
原创文章,作者:,如若转载,请注明出处:https://ce.771633.xyz/1660.html