昊天SEO

get_posts

描述

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

该函数属于 WordPress 的内置函数,用于在 WordPress 中提取多篇指定或随机文章。
越是描述简单的函数,使用起来就越是复杂,后面的需要仔细看咯!

用法

<?php $posts_array = get_posts( $args ); ?>

默认用法

<?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’ —— 按类型排序

示例

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

<?php
$posts_rand = get_posts("numberposts=3&orderby=rand");
?>

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

总结

其实 query_posts()  get_posts() 函数,接受大部分的参数,使用同样结构的数据库查询语句,并能达到一样的目的,但部分主题作者提示 query_posts()有可能会扰乱 WordPress 主循环,所以在这里不推荐使用。
get_posts 使用不难,难在获取文章后怎样在页面中显示,这里就需要有一定的 PHP 知识了。
如果是在文章循环之外想要将查询内容显示出来,可以看一下setup_postdata这个函数,这个函数会给那些用惯了模板标签的童鞋很大的帮助。

本文地址官网    新乡网站建设,seo

分享到:更多 ()

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址