码库记事本

码库记事本

详解WordPress开发中的get_post与get_posts函数使用

小诸哥 0

这篇文章主要介绍了WordPress开发中的get_post与get_posts函数使用,其中一般使用get_posts()函数来返回文章数组而较少使用get_post(),需要的朋友可以参考下

get_post()

在一般主题制作时,get_post()函数我们一般很少会用到,但因为后面会讲到get_posts(),所以我们不得不先讲一下这个单数形式。这个函数的主要作用是,将一片指定的文章以一个对象或是数组的形式返回,以便我们后期利用。下面让我们简单的了解一下他的使用方法。

get_post()函数说明

WordPress 的函数名总是那么浅显易懂,get_post()函数正如其表,即获得一篇文章,将一篇指定的文章以一个对象或是数组的形式返回,以便我们后期利用。

函数使用

  1. <?php 
  2.  get_post($post_id$output);  
  3. ?> 

$post_id变量,用于设置将要获取文章的ID,需要注意的是,这个变量我们不可以直接给一个实际值,那样会报错,我们只能以下面这样的形式调用。

$pid = 158;

get_post($pid);

如果像get_post(158);这样调用则会报错,$post_id,默认值是none,经测试,这个变量不设置会报错,个人感觉这个变量好像没有默认值。

$output 变量用于设置返回数据的类型,有三种,对象、关联数组、数值数组。

对象:OBJECT

关联数组:ARRAY_A

数值数组:ARRAY_N

默认值:OBJECT

使用实例

  1. <?php 
  2. $mypost_id = 158; 
  3. $post_id_158 = get_post($mypost_id, ARRAY_A); 
  4. $title = $post_id_158['post_title']; 
  5. ?> 

get_posts

get_posts 函数,简单的来讲是 get_post 的复数新形势,但因为是文章多篇提取,所以使用方法上却略有不同,支持众多参数选择需要提取的文章,在 CMS 主题中经常被用到,当然如果你对 WordPress 有更深了解的话,你也有可能是用 WP_Query 来替代该函数,这就是后话了,今天主要介绍一下 get_posts 函数。

get_posts 函数详解

该函数属于 WordPress 的内置函数,用于在 WordPress 中提取多篇指定或随机文章。

越是描述简单的函数,使用起来就越是复杂,后面的需要仔细看咯!

使用方法

  1. <?php  
  2. $args = array
  3.   'numberposts'   => 5, 
  4.   'offset'     => 0, 
  5.   'category'    => , 
  6.   'orderby'     => 'post_date'
  7.   'order'      => 'DESC'
  8.   'include'     => , 
  9.   'exclude'     => , 
  10.   'meta_key'    => , 
  11.   'meta_value'   => , 
  12.   'post_type'    => 'post'
  13.   'post_mime_type' => , 
  14.   'post_parent'   => , 
  15.   'post_status'   => 'publish' ); 
  16. $posts_array = get_posts( $args );  
  17. ?> 

$args是该函数必要的变量

get_posts( $args )将返回数组型的变量。

变量参数详解

  1. <?php  
  2. $args = array
  3.   //需要提取的文章数 
  4.   'numberposts'   => 10, 
  5.    
  6.   //以第几篇文章为起始位置 
  7.   'offset'     => 0, 
  8.    
  9.   //分类的ID,多个用逗号将分类编号隔开,或传递编号数组,可指定多个分类编号。 
  10.   //大部分 CMS 使用该函数的重点。 
  11.   'category'    => , 
  12.    
  13.   //排序规则(注1) 
  14.   'orderby'     => 'post_date'
  15.    
  16.   //升序、降序 'ASC' —— 升序 (低到高) 'DESC' —— 降序 (高到底) 
  17.   'order'      => 'DESC'
  18.    
  19.   //要显示文章的ID 
  20.   'include'     => , 
  21.    
  22.   //要排除文章的ID 
  23.   'exclude'     => , 
  24.    
  25.   //自定义字段名称 
  26.   'meta_key'    => , 
  27.   //自定义字段的值,配合上一个参数,来选择显示符合自定义字段数值的文章。 
  28.   'meta_value'   => , 
  29.    
  30.   //post(日志)——默认,page(页面), 
  31.   //attachment(附件),any —— (所有) 
  32.   'post_type'    => 'post'
  33.    
  34.   //文章的 mime 类型 
  35.   'post_mime_type' => , 
  36.    
  37.   //要显示文章的父级 ID 
  38.   'post_parent'   => , 
  39.    
  40.   //文章状态 
  41.   'post_status'   => 'publish' ); 
  42. ?> 

注:

‘author' —— 按作者数值编号排序

‘category' —— 按类别数值编号排序

‘content' —— 按内容排序

‘date' —— 按创建日期排序

‘ID' —— 按文章编号排序

‘menu_order' —— 按菜单顺序排序。仅页面可用。

‘mime_type' —— 按MIME类型排序。仅附件可用。

‘modified' —— 按最后修改时间排序。

‘name' —— 按存根排序。

‘parent' —— 按父级ID排序

‘password' —— 按密码排序

‘rand' —— 任意排序结果

‘status' —— 按状态排序

‘title' —— 按标题排序

‘type' —— 按类型排序

实例:

刚我们讲到用数组去传参,当然我们也可以用字符串来给该函数传参,下面给一个简单的例子。

  1. <?php 
  2. $posts_rand = get_posts('numberposts=3&orderby=rand'); 
  3. ?> 

以上代码用于随机在 WordPress 中获取3篇文章。

总结

其实 query_posts() 和 get_posts() 函数,接受大部分的参数,使用同样结构的数据库查询语句,并能达到一样的目的,但部分主题作者提示 query_posts()有可能会扰乱 WordPress 主循环,所以在这里不推荐使用。

get_posts 使用不难,难在获取文章后怎样在页面中显示,这里就需要有一定的 PHP 知识了。

如果是在文章循环之外想要将查询内容显示出来,可以看一下setup_postdata这个函数,这个函数会给那些用惯了模板标签的童鞋很大的帮助。

标签: 详解 开发 post 函数 使用