黄聪: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() 详解》,在这里也许你会获得更多参考。

时间: 2024-10-09 11:05:12

黄聪:get_posts 函数 | wordpress的相关文章

黄聪:走进wordpress do_action函数

再看do_action函数.位于plugin.php352行.我把源码放在西街口这里,略去了其它辅助处理的语句. 如下: function do_action($tag, $arg = '') {     ++$wp_actions[$tag]; //计数器加1,did_action中用到       do {         foreach ( (array) current($wp_filter[$tag]) as $the_ )             if ( !is_null($the

get_posts()函数wordpress调用指定ID文章多篇文章

wordpress内置函数get_posts()用于调用指定的一篇或多篇文章,函数提供多个参数,可以设置调用文章的指定分类.自定义字段.文章类型.文章状态.显示顺序等条件,文章以数组的形式返回,通过循环语句输出即可. 代码结构: 1 <?php get_posts($args);?> 返回数组型的变量,$args是该函数必要的变量 变量$args参数: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

黄聪:走进wordpress 详细说说template-loader.php

再看template-laoder.php,这个文件总共只有45行.它的作用是基于访问的URL装载正确的模板. 文件第六行,也是第一条语句,如下: if ( defined('WP_USE_THEMES') && WP_USE_THEMES ) do_action('template_redirect'); 首先判断是否使用Themes,这个WP_USE_THEMES常量在index.php中第一句就被设置为true.因此条件成立,会执行do_action(‘template_redire

黄聪:使用WORDPRESS自带AJAX方法

例如给网站每页logo后面的一句名言,点击“换一条”就会ajax动态加载一条,使用了wordpress的自带ajax方法.下面介绍如何使用wordpress自带ajax方法: 1.在header.php文件加入html和js html: <span id="random"><i id="say"><?php echo random_str();?></i> [<a href="javascript:vo

黄聪:在WordPress后台文章编辑器的上方或下方添加提示内容

WordPress 3.5 新增了一对非常有用的挂钩,可以快速在WordPress后台文章编辑器的上方或下方添加提示内容,下面是一个简单的例子,直接将代码添加到主题的 functions.php 文件: function below_the_title() { echo '<h3>在编辑器上方添加的提示内容</h3>'; }   add_action( 'edit_form_after_title', 'below_the_title' );   function below_th

黄聪:禁止wordpress版本自动升级的解决方案

在WordPress配置文件中找到wp-config.php,添加如下常量 define( 'AUTOMATIC_UPDATER_DISABLED', true );

黄聪:WordPress 多站点建站教程(六):使用WP_Query、switch_to_blog函数实现获取子站点分类中的文章

首先在你使用主题的funtions.php里面添加下代码: //根据时间显示最新的分类文章内容,每个站点显示一篇内容 //$blog_id 子站点ID //$catid 分类ID wp_reset_query(); switch_to_blog($blog_id); global $post;?> $my_query2 = new WP_Query('showposts=1&order=desc&orderby=date&cat='.$catid); while ($my_q

黄聪:《跟黄聪学WordPress主题开发》

又一个作品完成!<跟黄聪学Wordpress主题开发>,国内最好的Wordpress主题模版开发视频教程!! 目录预览: WordPress官方源文件层式结构讲解 WordPress数据库表结构.字段详解 WordPress主题模版加载过程 WordPress主题模版开发:主题模版的安装及创建 WordPress主题模版开发:首页模版及调用options表数据 WordPress主题模版开发:如何循环输出文章列表 WordPress主题模版开发:文章元数据及多语言化 WordPress主题模版

黄聪:wordpress中remove_action、add_action、 do_action()的hook钩子都有哪些

原文地址:http://codex.wordpress.org/Plugin_API/Action_Reference muplugins_loaded After must-use plugins are loaded registered_taxonomy For category, post_tag, etc. registered_post_type For post, page, etc. plugins_loaded After active plugins and pluggabl