Z-Blog Wiki Z-Blog Wiki

Z-Blog官方文档

用户工具

站点工具


zblogphp:development:functions:getlist

GetList 函数

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

语法

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

$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));}
<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>

zblogphp/development/functions/getlist.txt · 最后更改: 2016/06/21 16:47 (外部编辑)