zblog php getlist,ZBlog开发教程：GetList 函数的详细用法

通过GetList可以获取自定义的文章列表，如指定分类的最新文章、置顶文章等等

语法Array GetList($count = 10, $cate = null, $auth = null, $date = null, $tags = null, $search = null, $option = null)

调用参数参数类型参数默认值描述int$count10提取条数

int$catenull分类ID

int$authnull用户ID

string$datenull时间

mixed$tagsnull标签ID、名称或者标签数组

string$searchnull搜索关键字

array$optionnull附加选项

参数说明

tags

tags参数允许使用三种类型：int,string,array参数类型示例int2

string“abc”

arrayArray(

[0] ⇒ Tag Object0,

[1] ⇒ Tag Object1

)

option

option参数可指定更多配置选项，参考如下$option = array (

"only_ontop"  => true //

"only_not_ontop"  => true

"has_subcate"  => true  //输出子分类文章

"is_related"  => $article->ID //输出与指定文章具有相同tag的文章列表，剔除指定ID的文章，如当前文章ID($article->ID)

);

返回值

返回指定的文章列表数组，默认返回10条最近发表的文章，结构如下：Array

(

[0] => Post Object0

[1] => Post Object1

)

代码示例

例1

获取10条最近发表的文章$array=Getlist();

例2

获取分类ID为3下的10条最近发表的文章$array=Getlist(10,3);

例3

获取文章中使用标签ID=1或标签名=“abc”的列表$array=Getlist(10,null,null,null,array($zbp->GetTagByID(1),$zbp->GetTagByAliasOrName('abc')));

例4

搜索正文或标题内容里含有'abc'的10条文章$array=Getlist(10,null,null,null,null,'abc');

例5

搜索$article的相关文章(ZC_RELATEDLIST_COUNT选项默认为10)$array=GetList($zbp->option['ZC_RELATEDLIST_COUNT'],null,null,null,null,null,array('is_related'=>$article->ID));

在模板中，获取并输出获取到的相关文章代码参考如下{$array=GetList($zbp->option['ZC_RELATEDLIST_COUNT'],null,null,null,null,null,array('is_related'=>$article->ID));}

{foreach $array as $related}

{$related.Time('m-d')} {$related.Title}

{/foreach}