get_posts 函数 | wordpress
get_posts 函数,简单的来讲是 get_post 的复数新形势,但因为是文章多篇提取,所以使用方法上却略有不同,支持众多参数选择需要提取的文章,在 CMS 主题中经常被用到,当然如果你对 WordPress 有更深了解的话,你也有可能是用 WP_Query 来替代该函数,这就是后话了,今天主要介绍一下 get_posts 函数。
get_posts 函数详解
该函数属于 WordPress 的内置函数,用于在 WordPress 中提取多篇指定或随机文章。
越是描述简单的函数,使用起来就越是复杂,后面的需要仔细看咯!
使用方法
<?php $args = array('numberposts' => 5,'offset' => 0,'category' => ,'orderby' => 'post_date','order' => 'DESC','include' => ,'exclude' => ,'meta_key' => ,'meta_value' => ,'post_type' => 'post','post_mime_type' => ,'post_parent' => ,'post_status' => 'publish' ); $posts_array = get_posts( $args ); ?>
$args
是该函数必要的变量
get_posts( $args )
将返回数组型的变量。
变量参数详解
<?php $args = array(//需要提取的文章数'numberposts' => 10,//以第几篇文章为起始位置'offset' => 0,//分类的ID,多个用逗号将分类编号隔开,或传递编号数组,可指定多个分类编号。//大部分 CMS 使用该函数的重点。'category' => ,//排序规则(注1)'orderby' => 'post_date',//升序、降序 'ASC' —— 升序 (低到高) 'DESC' —— 降序 (高到底)'order' => 'DESC',//要显示文章的ID'include' => ,//要排除文章的ID'exclude' => ,//自定义字段名称'meta_key' => ,//自定义字段的值,配合上一个参数,来选择显示符合自定义字段数值的文章。'meta_value' => ,//post(日志)——默认,page(页面),//attachment(附件),any —— (所有)'post_type' => 'post',//文章的 mime 类型'post_mime_type' => ,//要显示文章的父级 ID'post_parent' => ,//文章状态'post_status' => 'publish' ); ?>
注1: ‘author’ —— 按作者数值编号排序 ‘category’ —— 按类别数值编号排序 ‘content’ —— 按内容排序 ‘date’ —— 按创建日期排序 ‘ID’ —— 按文章编号排序 ‘menu_order’ —— 按菜单顺序排序。仅页面可用。 ‘mime_type’ —— 按MIME类型排序。仅附件可用。 ‘modified’ —— 按最后修改时间排序。 ‘name’ —— 按存根排序。 ‘parent’ —— 按父级ID排序 ‘password’ —— 按密码排序 ‘rand’ —— 任意排序结果 ‘status’ —— 按状态排序 ‘title’ —— 按标题排序 ‘type’ —— 按类型排序
实例
刚我们讲到用数组去传参,当然我们也可以用字符串来给该函数传参,下面给一个简单的例子。
<? $rand_posts = get_posts('numberposts=3&orderby=rand'); ?> <ul> <?foreach ( $rand_posts as $post ) {setup_postdata( $post ); ?><li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li> <? } wp_reset_postdata(); ?> </ul>
以上代码用于随机在 WordPress 中获取3篇文章。
总结
其实 query_posts()
和 get_posts()
函数,接受大部分的参数,使用同样结构的数据库查询语句,并能达到一样的目的,但部分主题作者提示 query_posts()
有可能会扰乱 WordPress 主循环,所以在这里不推荐使用。
get_posts
使用不难,难在获取文章后怎样在页面中显示,这里就需要有一定的 PHP 知识了。
如果是在文章循环之外想要将查询内容显示出来,可以看一下setup_postdata这个函数,这个函数会给那些用惯了模板标签的童鞋很大的帮助。
文献
WordPress 官方文档 :《Function Reference/get post》
之前讲过这个函数的单数形式 《get_post() 详解》,在这里也许你会获得更多参考。
本文转自黄聪博客园博客,原文链接:http://www.cnblogs.com/huangcong/p/4771825.html,如需转载请自行联系原作者
get_posts 函数 | wordpress相关推荐
- php中get_featured_posts()是什么意思,WordPress的Get_Posts()函数详解
WP中获取POST有两个主要函数,Get_post()和Get_Posts().一个是获取单文章,另外一个是获取多文章,其中,官网对Get_posts()函数的描述很简单.但有的时候描述越简单的函数, ...
- have_posts 修改_探索WordPress的get_posts函数
have_posts 修改 Many WordPress plugins retrieve posts from the database by customizing the sorting ord ...
- ?php query_posts(cat)?,query_posts()函数 (wordpress日志调用)
我们在修改和自己创新wordpress模板的时候,经常会遇到while(has_post()):the_post()的循环,例如首页,我们几乎不能忘记这循环的重要意义,即这是出现文章及其各个属性的唯一 ...
- action中写php函数,WordPress中add_action(将函数连接到指定action)
WordPress中add_action(将函数连接到指定action) 首先说下WordPress中用的钩子,将一个函数,以一个新的动作命名,该函数就是 语法: 1 2 3 add_action($ ...
- php中mimes函数,wordpress函数check_upload_mimes()用法示例
check_upload_mimes( array $mimes ) Check an array of MIME types against a whitelist. 描述 WordPress sh ...
- PHP Calendar 函数,wordpress函数get_calendar()用法示例
get_calendar( bool $initial = true, bool $echo = true ) Display calendar with days that have posts a ...
- html class函数,wordpress函数sanitize_html_class()用法示例
sanitize_html_class( string $class, string $fallback = '' ) Sanitizes an HTML classname to ensure it ...
- wordpress文章列表获取函数:get_posts
wordpress提前文章列表,我们需要用到get_posts函数,它的使用非常简单,只需要传入对应的参数即可. 下面是它的具体用户和常用到的参数 $args = array( 'numberpost ...
- WordPress 函数大全
1.bloginfo() 顾名思义,该 函数 主要用来显示博客信息;而且根据参数的不同,可以用来显示博客信息中的不同部分.常用的有以下几种: bloginfo('name') 显示博客题名,如&quo ...
- wordpress教程之函数讲解
wordpress函数收集 is_home() : 是否为主页 is_single() : 是否为内容页(Post), 是否是单篇文章 is_page() : 是否为内容页(Page), ...
最新文章
- 美妆彩妆宣传PPT模板
- HTML+CSS基础(2)-HTML标签的简单介绍和网页注释
- MySQL(mysql 5.7)用户密码的管理
- 前向业务中间层的意义,架构,技能要求
- global mapper 制作地形图_福州大飞机模型制作厂家,产品模型,期待合作_境海模型...
- boost::stl_interfaces::detail相关的测试程序
- Oracle入门(十二J)之同义词
- zabbix安装过程
- linux touch 源码,每天一个Linux命令(09)--touch命令
- S.Finance已上线收益稳定币UU
- mybatis里面返回list集合
- Oracle数据库出现问题时,这十个脚本帮你快速定位原因
- StanfordDB class自学笔记 (4) XML Data
- sql 获取当前之后某天的日期
- PHP在线工具箱源码站长引流+在线工具箱源码+多款有趣的在线工具+一键安装
- 华为内部最为神秘的部门——2012实验室
- 发动机和变速箱工作原理
- RPA 软件技术是什么意思
- Source Insight 许可证激活与停用
- 家谱树(gentree)