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相关推荐

  1. php中get_featured_posts()是什么意思,WordPress的Get_Posts()函数详解

    WP中获取POST有两个主要函数,Get_post()和Get_Posts().一个是获取单文章,另外一个是获取多文章,其中,官网对Get_posts()函数的描述很简单.但有的时候描述越简单的函数, ...

  2. have_posts 修改_探索WordPress的get_posts函数

    have_posts 修改 Many WordPress plugins retrieve posts from the database by customizing the sorting ord ...

  3. ?php query_posts(cat)?,query_posts()函数 (wordpress日志调用)

    我们在修改和自己创新wordpress模板的时候,经常会遇到while(has_post()):the_post()的循环,例如首页,我们几乎不能忘记这循环的重要意义,即这是出现文章及其各个属性的唯一 ...

  4. action中写php函数,WordPress中add_action(将函数连接到指定action)

    WordPress中add_action(将函数连接到指定action) 首先说下WordPress中用的钩子,将一个函数,以一个新的动作命名,该函数就是 语法: 1 2 3 add_action($ ...

  5. php中mimes函数,wordpress函数check_upload_mimes()用法示例

    check_upload_mimes( array $mimes ) Check an array of MIME types against a whitelist. 描述 WordPress sh ...

  6. PHP Calendar 函数,wordpress函数get_calendar()用法示例

    get_calendar( bool $initial = true, bool $echo = true ) Display calendar with days that have posts a ...

  7. html class函数,wordpress函数sanitize_html_class()用法示例

    sanitize_html_class( string $class, string $fallback = '' ) Sanitizes an HTML classname to ensure it ...

  8. wordpress文章列表获取函数:get_posts

    wordpress提前文章列表,我们需要用到get_posts函数,它的使用非常简单,只需要传入对应的参数即可. 下面是它的具体用户和常用到的参数 $args = array( 'numberpost ...

  9. WordPress 函数大全

    1.bloginfo() 顾名思义,该 函数 主要用来显示博客信息;而且根据参数的不同,可以用来显示博客信息中的不同部分.常用的有以下几种: bloginfo('name') 显示博客题名,如&quo ...

  10. wordpress教程之函数讲解

    wordpress函数收集 is_home() : 是否为主页 is_single() : 是否为内容页(Post),   是否是单篇文章   is_page() : 是否为内容页(Page),   ...

最新文章

  1. 美妆彩妆宣传PPT模板
  2. HTML+CSS基础(2)-HTML标签的简单介绍和网页注释
  3. MySQL(mysql 5.7)用户密码的管理
  4. 前向业务中间层的意义,架构,技能要求
  5. global mapper 制作地形图_福州大飞机模型制作厂家,产品模型,期待合作_境海模型...
  6. boost::stl_interfaces::detail相关的测试程序
  7. Oracle入门(十二J)之同义词
  8. zabbix安装过程
  9. linux touch 源码,每天一个Linux命令(09)--touch命令
  10. S.Finance已上线收益稳定币UU
  11. mybatis里面返回list集合
  12. Oracle数据库出现问题时,这十个脚本帮你快速定位原因
  13. StanfordDB class自学笔记 (4) XML Data
  14. sql 获取当前之后某天的日期
  15. PHP在线工具箱源码站长引流+在线工具箱源码+多款有趣的在线工具+一键安装
  16. 华为内部最为神秘的部门——2012实验室
  17. 发动机和变速箱工作原理
  18. RPA 软件技术是什么意思
  19. Source Insight 许可证激活与停用
  20. 家谱树(gentree)

热门文章

  1. Java中的异或(转)
  2. ANDROID常用的命令(转载,后续自己完善)
  3. 如何用最简单的方法将PCweb改成适合各种设备的web
  4. hive 安装centos7
  5. 【poj1995】快速幂
  6. JS中Null与Undefined的区别
  7. PAT:1059. Prime Factors (25) AC
  8. SharePoint 2010列表中新增的唯一性验证
  9. 基础—数学—Exponential Family
  10. 【解决方案】K2 BPM_赋能房地产业务高效运营_全球领先的工作流引擎