WordPress常用函数get posts

来自站长百科
跳转至: 导航、​ 搜索

导航: 上一页 | 首页 | WordPress中文论坛 | WordPress主机 | CMS程序 | 论坛程序 | ECShop | ShopNC | PowerEasy

说明[ ]

这是一个用于创建多环路的简单标签。  

用法[ ]

 <?php get_posts('arguments'); ?>   

示例[ ]

最初到现在的文章列表[ ]

如果在博客首页上只设置显示一篇文章,但同时希望在分类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

相关条目[ ]