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 | $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参数可指定更多配置选项,参考如下
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条)
获取分类ID为3下的10条最近发表的文章
获取文章中使用标签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)); |
在模板中,获取并输出获取到的相关文章代码参考如下
1 2 3 4 5 6 |
{$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
© 版权声明
转载请注明来自白芸资源网以及原文地址。
本站不敢保证内容的可靠性,内容仅供小范围学习与参考,禁止用于商业、盈利或其它非法用途以及大范围传播,您需在学习与参考完毕后从您的个人存储空间彻底删除,因您滥用而造成的损失本站不承担法律责任。
本站部分内容可能源于互联网,版权争议与本站无关,如有侵权可联系站长处理,敬请谅解!
请您合法使用本站资源。
THE END