时间:2024-03-15
WordPress模板标签get_posts用于获取文章信息,通常用于输出最新文章列表、随机文章、指定分类文章等等,在用WordPress制作CMS网站时非常有用。
get_posts( array $args = null )
数组或字符串值
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
相关函数:
get_pages()
Copyright © 2019-2024 jsp.hk