在zblog asp版本制作zblog CMS模板时,调用自定义的文章列表时,通常会选择使用功能强大的YTCMS插件,而zblog php版本提供了GetList函数,通过该函数可以获取自定义的文章列表,如指定分类的最新文章、置顶文章等等,非常实用。
GetList 函数语法:
ArrayGetList($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]=>PostObject0[1]=>PostObject1)
代码示例
获取10条最近发表的文章($count默认是10条)
$array=Getlist();
获取分类ID为3下的10条最近发表的文章
$array=Getlist(10,3);
获取文章中使用标签ID=1或标签名=“abc”的列表
$array=Getlist(10,null,null,null,array($zbp->GetTagByID(1),$zbp->GetTagByAliasOrName('abc')));
搜索正文或标题内容里含有’abc’的10条文章
$array=Getlist(10,null,null,null,null,'abc');
搜索$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$arrayas$related}{$related.Time('m-d')}{$related.Title}{/foreach}