WordPress获取文章标签:get_posts
文 / @WordPress主题
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
相关函数:
- get_pages()
相关文章
-
如何创建WordPress古腾堡编辑器的区块(PHP+原生JS) 2024-01-10 01:01:06
-
搭建一个WordPress网站需要多少成本 2023-11-06 00:09:51
-
Symlink介绍(附:如何使用Symlink进行WordPress开发) 2023-11-05 23:38:32
-
让WordPress实现数据库同步的插件:HyperDB 2023-10-24 23:40:49
-
allegro电商平台值得做吗(附:2023年Allegro注册流程指南) 2023-10-08 21:53:39
-
印度跨境电商平台有哪些(附:印度跨境电商做什么产品好) 2023-10-08 21:34:23
-
跨境电商必看的几大海外二手电商平台 2023-10-08 18:04:42
-
WordPress同城互联网产品解决方案:UBASE 2023-10-03 16:40:39
-
WordPress网站的安全插件:wordfence 2023-09-14 09:25:18
-
WordPress 6.3 支持在手动更新插件和主题失败后回滚旧版本 2023-08-28 16:58:45