首页 / 技术 / 正文

wordpress的get_posts()函数参数介绍

2013年12月10日 暂无评论 ... 技术 /

get_posts()函数是wordpress中的经典函数,作用是提取文章。他是get_post()的复数形式,所以get_posts()的参数非常多,通过对此函数的参数设置可以对文章排列顺序等进行排列,使得文章获取的更加灵活。

wordpress使用手册中的 get_posts() 函数的标准使用方法如下,其中的$args是中间参数,实际使用的是可以直接在get_posts()括号里面直接填写参数。

<?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 );
?>

 

以上是所有的支持的参数,下面我仔细讲解一下这些函数的作用。

'numberposts' => 10, //获取的文章数量,此例中显示的是10篇文章

'offset' => 0, //从默认顺序里的第几篇文章开始获取,默认是0,就是从头开始,如果要从第二篇,就可以将此参数修改成为1,这个参数适用于文章分列,或者首篇文章不同于其他文章显示

'category' => , //分类的ID,多个用逗号将分类编号隔开,用来指定显示某个分类的文章,此项目对CMS主题来讲是精华

'orderby' => 'post_date', //排序规则,此例为按照时间顺序,默认也是时间顺序

'order' => 'DESC', //'ASC'升序,'DESC' 降序

'include' => , //获取要显示文章的ID,多个用顿号分开

'exclude' => , //排除文章的ID,多个用顿号分开

'meta_key' => , //自定义字段名称

'meta_value' => , //自定义字段的值

'post_type' => 'post', //获取的类型,比如文章或者页面

'post_mime_type' => , //文章的 mime 类型

'post_parent' => , //要显示文章的父级 ID

'post_status' => 'publish' //文章状态

 

实际上,真正用的很频繁的是'numberposts','offset,'category','include','exclude',在实际用的时候,没必要按照说明书中的还要做一个中间参量,可以直接添加,并且省略掉“>”,直接“参数=内容”,不同参数中间使用&符号链接。

 

来个实例:

这是我在制作双栏主题的时候在第一个DIV中放入了如下PHP代码:

<?php
$rand_posts = get_posts('numberposts=16&offset=0&orderby=new');
foreach( $rand_posts as $post ) :
?>
<li><span><?php the_time('m-d') ?> </span><a href="<?php the_permalink(); ?>" title="<?php the_title(); ?>"><?php the_title(); ?></a></li>
<?php endforeach; ?>

第二个DIV中放入了这样的代码:

<?php
$rand_posts = get_posts('numberposts=16&offset=16&orderby=new');
foreach( $rand_posts as $post ) :
?>
<li><span><?php the_time('m-d') ?> </span><a href="<?php the_permalink(); ?>" title="<?php the_title(); ?>"><?php the_title(); ?></a></li>
<?php endforeach; ?>

 

这样的话,就可以实现获取16个文章,然后按照每16个排成一列,分两列显示。

暂无评论

发布评论