在zblog asp版本制作zblog CMS模板时，调用自定义的文章列表时，通常会选择使用功能强大的YTCMS插件，而zblog php版本提供了GetList函数，通过该函数可以获取自定义的文章列表，如指定分类的最新文章、置顶文章等等，非常实用。

GetList 函数语法：

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

调用参数

参数类型参数默认值描述
int $count 10 提取条数
int $cate null 分类ID
int $auth null 用户ID
string $date null 时间
mixed $tags null 标签ID、名称或者标签数组
string $search null 搜索关键字
array $option null 附加选项

参数说明

tags

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

参数类型示例
int 2
string “abc”
array Array([0] ⇒ Tag Object0,[1] ⇒ Tag Object1)

option

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

123456 $option = array ( "only_ontop" => true // "only_not_ontop" => true "has_subcate" => true //输出子分类文章 "is_related" => $article->ID //输出与指定文章具有相同tag的文章列表，剔除指定ID的文章，如当前文章ID（$article->ID）);

返回值

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

12345 Array( [0] => Post Object0 [1] => Post Object1)

代码示例

获取10条最近发表的文章（$count默认是10条）

1 $array=Getlist();

获取分类ID为3下的10条最近发表的文章

1 $array=Getlist(10,3);

获取文章中使用标签ID=1或标签名=“abc”的列表

1 $array=Getlist(10,null,null,null,array($zbp->GetTagByID(1),$zbp->GetTagByAliasOrName(’abc’)));

搜索正文或标题内容里含有’abc’的10条文章

1 $array=Getlist(10,null,null,null,null,’abc’);

搜索$article的相关文章(ZC_RELATEDLIST_COUNT选项默认为10)

1 $array=GetList($zbp->option[’ZC_RELATEDLIST_COUNT’],null,null,null,null,null,array(’is_related’=>$article->ID));

在模板中，获取并输出获取到的相关文章代码参考如下

123456 {$array=GetList($zbp->option[’ZC_RELATEDLIST_COUNT’],null,null,null,null,null,array(’is_related’=>$article->ID));}<ul id="related">{foreach $array as $related} <li><span class="time">{$related.Time(’m-d’)}</span><span class="title"><a href="{$related.Url}" title="{$related.Title}">{$related.Title}</a></span></li>{/foreach}</ul>

介绍内容来自Z-Blog Wiki

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。