wordpress关于日志的常用函数-get_posts

模板标签-get_posts
说明
这是一个用于创建多环路的简单标签。用于检索最新的或者匹配条件的文章列表。
注意,虽然参数与get_pages方法类似,但是有几个参数略有不同。
 
用法
 <?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 );
 ?>
 
最初到现在的文章列表
如果在博客首页上只设置显示一篇文章,但同时希望在分类ID 1中显示最近五篇文章的链接,可使用如下代码:
 <ul>  
<?php  
global $post;  
$myposts = get_posts('numberposts=5&offset=1&category=1');  
foreach($myposts as $post) :  
?>     
   <li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
</li>  
 <?php endforeach; ?>  
 </ul>  
注意使用offset时,以上查询仅适用于含有一篇以上文章的分类,否则无法输出。
获取所有文章资料
默认情况下get_posts无法获取一些文章相关数据,如通过 the_content()获取文章内容或序列ID。调用内部函数setup_postdata(),以$post 数组为其自变量,可以解决这一问题:
<?php  
$lastposts = get_posts('numberposts=3');  
foreach($lastposts as $post) :     
   setup_postdata($post);  
?>  
<h2><a href="<?php the_permalink(); ?>" id="post-<?php the_ID(); ?>"><?php the_title(); ?></a></h2>  
<?php the_content(); ?>  
<?php endforeach; ?> 
不希望通过调用setup_postdata()来获取文章的ID或内容,或者获取文章的任何相关数据时(数据存留在文章列表中),可以使用$post->COLUMN,COLUMN是文章数据表格的纵列名称。因此$post->ID指明文章ID,$post->post_content指明文章内容,以此类推。如要在页面上显示这些数据,请使用PHP echo命令,如下所示:
<?php echo $post->ID; ?>  
按标题为最新发表文章排序
以下代码可按字母升序显示最近发表的十篇文章的发布日期、标题和摘要:
<?php 
$postslist = get_posts('numberposts=10&order=ASC&orderby=title'); 
foreach ($postslist as $post) :      
   setup_postdata($post); 
?>   
<div> 
<?php the_date(); ?>  
<br />
<?php the_title(); ?>     
<?php the_excerpt(); ?>  
</div>  
<?php endforeach; ?>    
注意排序参数在2.6版本中有所修改。此代码适用于新排序格式。详细内容参见参数
任意文章
MySQL RAND()函数指定排序参数的值,可以显示出随意选择的五篇文章:
<ul><li><h2>A random selection of my writing</h2>     
   <ul>  
<?php  
$rand_posts = get_posts('numberposts=5&orderby=rand');  
foreach( $rand_posts as $post ) :  
?>     
   <li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li>  
<?php endforeach; ?>     
   </ul>  
</li></ul>  
 
显示所有附件
不用模板中任何循环进行本项操作。
(使用2.5版本后的get_children()函数相对方便。)
<?php   
$args = array(        
       'post_type' => 'attachment', 
       'numberposts' => -1,   
       'post_status' => null,        
       'post_parent' => null, // any parent 
       );  
$attachments = get_posts($args); 
if ($attachments) {   
      foreach ($attachments as $post) {             
              setup_postdata($post);                
              the_title();           
              the_attachment_link($post->ID, false);                
              the_excerpt();  
      } 
}   
?> 
显示最新文章的附件
The_Loop($post->ID可用)中进行本类操作。
 
<?php  
 
$args = array(        
       'post_type' => 'attachment', 
       'numberposts' => -1,   
       'post_status' => null,        
       'post_parent' => $post->ID    
       );  
$attachments = get_posts($args); 
if ($attachments) {   
      foreach ($attachments as $attachment) {               
              echo apply_filters('the_title', $attachment->post_title);            
              the_attachment_link($attachment->ID, false); 
      } 
}    
?> 

参数:WordPress 2.6+
除“WordPress 2.5及更早版本”中列出的参数外,get_posts( )也能运行query_posts( )所操作的参数,目前这两个函数在内部使用相同的数据库查询代码。
注意:2.6版本对一些排序选项做了更改。表格字段前不再含有post_字样。如post_title已被改为title,post_data改为data。
 
参数:WordPress 2.5及更早版本
$numberposts
(整数)(可选)将要返回的文章数量。将其设为0可在每页上显示最大数量文章数,设为-1可消除限制。
默认值:5
$offset
(整数)(可选)以最新文章为起始位
默认值:0
$category
(整数)(可选)仅显示本分类编号下的文章。将分类编号设为负数(如果是3,设为-3),显示结果不匹配。用逗号将分类编号隔开,或传递编号数组,可指定多个分类编号。
默认值:None
$category_name
(字符)(可选)仅显示本分类名称或分类缩略名下的文章。
默认值:None
$tag
(字符)(可选)仅显示本标签缩略名下的文章。若指定多个用逗号隔开的标签缩略名,则返回结果是:所有文章都与某个标签匹配。若指定多个用空格隔开的标签缩略名,返回结果是:所有文章都与指定标签缩略名匹配。
默认值:None
$orderby
(字符)(可选)按不同值(用空格隔开)为文章排序,包括:

  • 'author' —— 按作者数值编号排序
  • 'category' —— 按类别数值编号排序
  • 'content' —— 按内容排序
  • 'date' —— 按创建日期排序
  • 'ID' —— 按文章编号排序
  • 'menu_order' —— 按菜单顺序排序。仅页面可用。
  • 'mime_type' —— 按MIME类型排序。仅附件可用。
  • 'modified' —— 按最后修改时间排序。
  • 'name' —— 按存根排序。
  • 'parent' —— 按父级ID排序
  • 'password' —— 按密码排序
  • 'rand' —— 任意排序结果
  • 'status' —— 按状态排序
  • 'title' —— 按标题排序
  • 'type' —— 按类型排序

注意

  • 按编号排序和任意排序自2.5版本起启用。

默认值:post_date
$order
(字符)(可选)如何对$order排序。可能的值为:

  • 'ASC' —— 升序 (低到高)
  • 'DESC' —— 降序 (高到底)

默认值:DESC
$include
(字符)(可选)希望显示的文章编号,用逗号和/或空格隔开。显示六篇文章时,下列值可能生效:

  • '45,63,78 94,128,140'

注意:该参数将改写numberposts,offset,category,exclude,meta_key,meta_value,及post_parent参数。
默认值:None
$exclude
(字符)(可选)不希望显示的文章编号,用逗号和/或空格隔开(参见$include参数)。
默认值:None
$meta_key 和$meta_value
(字符)(可选)仅显示含有该关键词和值的元(自定义)字段的文章。两项参数都应定义,否则无法运行。
默认值:None
$post_type
(字符)(可选)希望显示的文章类型。可选项有:

  • post —— 默认
  • page
  • attachment
  • any —— 任意文章类型

默认值:post
$post-status
(字符)(可选)显示特定状态的文章。可选项有:

  • publish
  • private
  • draft
  • future
  • inherit —— 若$post_type设为附件,则此项为默认选项
  • (blank)—— 所有状态

默认值:publish
$post_parent
(整数)(可选)显示此文章编号下的子文章
默认值:None
$nopaging
(布尔型)(可选)激活或禁用分页功能。如果禁用,$numberposts选项被略过。
默认值:None
 
 

wordpress关于日志的常用函数-get_post_type()

说明
检索当前文章或给定文章的文章类型。
用法
<?php get_post_type( $post ) ?>
参数
$post

(混合)(可选)文章对象或文章ID。
默认值: false
返回的值
(布尔型| 字符)

返回文章类型,出错时返回false。
示例
<?php 
$post_type =get_post_type(36);
//假设id为36的文章类型为附件类型attachment
echo $post_type;
//打印出attachment
?>
注释

  • 用法:$posts 日志循环的全局变量

修改记录
自2.1.0版本后
源文件
get_post_type() 位于wp-includes/post.php中
/**
 * Retrieve the post type of the current post or of a given post.
 *
 * @since 2.1.0
 *
 * @uses $post The Loop current post global
 *
 * @param mixed $the_post Optional. Post object or post ID.
 * @return bool|string post type or false on failure.
 */
function get_post_type( $the_post = false ) {
         global $post;
 
         if ( false === $the_post )
                   $the_post = $post;
         elseif ( is_numeric($the_post) )
                   $the_post = get_post($the_post);
 
         if ( is_object($the_post) )
                   return $the_post->post_type;//返回文章的类型post_type
 
         return false;
}

wordpress关于日志的常用函数get_post_status()

说明
按ID编号检索文章的状态。
如果文章的ID号为附件则返回该附件文章的状态。
用法
<?php get_post_status($ID); ?>
参数
$ID
(整数)(可选)文章ID若未提供$ID则该函数返回False。
默认值:"
返回的值
(字符|布尔型)
返回文章的状态,出错时则返回False。
可能的返回值:

  • 'publish' – 已经发表的文章或页面
  • 'pending' – 文章正在等待审查
  • 'draft' – 草稿状态
  • 'auto-draft' – 自动保存的草稿
  • 'future' – 未来的时间发布
  • 'private' – 登录后可见
  • 'inherit' – 修订
  • 'trash' – 在回收站中.版本2.9.增加

 
示例
<?php
$ post_status = get_post_status ( 36 );//假设id为36的文章类型是“publish”
echo $post_status;

//打印出 publish
 ?>
修改记录
自2.0.0版本后
源文件
get_post_status () 位于wp-includes/post.php中。

/**
 * Retrieve the post status based on the Post ID.
 *
 * If the post ID is of an attachment, then the parent post status will be given
 * instead.
 *
 * @since 2.0.0
 *
 * @param int $ID Post ID
 * @return string|bool Post status or false on failure.
 */
function get_post_status($ID = '') {
    $post = get_post($ID);
 
    if ( !is_object($post) )
       return false;
 
    if ( 'attachment' == $post->post_type ) {
       if ( 'private' == $post->post_status )
           return 'private';
 
       // Unattached attachments are assumed to be published
       if ( ( 'inherit' == $post->post_status ) && ( 0 == $post->post_parent) )
           return 'publish';
 
       // Inherit status from the parent
       if ( $post->post_parent && ( $post->ID != $post->post_parent ) )
           return get_post_status($post->post_parent);
    }
 
    return $post->post_status;//返回文章的post_status字段
}