资源仓

zblog php调用自定义文章列表函数GetList()介绍

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$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参数可指定更多配置选项,参考如下

1
2
3
4
5
6
$option = array ("only_ontop"  => true //"only_not_ontop"  => true"has_subcate"  => true  //输出子分类文章"is_related"  => $article->ID //输出与指定文章具有相同tag的文章列表,剔除指定ID的文章,如当前文章ID($article->ID));

返回值

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

1
2
3
4
5
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($count = 10, $cate = null, $auth = null, $date = null, $tags = null, $search = null, $option = null)5

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

1
2
3
4
5
6
{Array GetList($count = 10, $cate = null, $auth = null, $date = null, $tags = null, $search = null, $option = null)5}<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


发表评论

还没有评论,快来说点什么吧~

联系客服
网站客服 业务合作 Q交流群
474730671
公众号
公众号
公众号
返回顶部