====== GetList 函数======
通过GetList可以获取自定义的文章列表,如指定分类的最新文章、置顶文章等等
===== 1.7新版本的语法及参数 =====
$result = GetList(array('count'=>10)) //返回array(Post类型) 或是 空array()
array参数如下
array(
'count' => 10, //(可省略)
'cate' => 1, //(可省略)
'auth' => 2, //(可省略)
'date' => '2020-1', //(可省略)
'tags' => 'abc', //(可省略)
'search' => 's', //(可省略)
//以下是原$option参数的key键
'post_type' => null, //指定查询Post表的类型 (可省略)
'post_status' => null, //指定查询Post表的状态 (可省略)
'only_ontop' => false, //指定全是置顶 (可省略)
'only_not_ontop' => false, //指定全不是置顶 (可省略)
'has_subcate' => false, //指定包含子孙目录 (可省略)
'is_related' => false, //指定查询相关文章 (可省略)
'order_by_metas' => false, //指定按Metas值排序输出结果 (可省略)
'random' => 5, //指定抽取5篇Post表的记录 (可省略)
'where_custom' => array(array('=', 'log_Template', '')), //自定义where
'order_custom' => array('log_ViewNums' => 'DESC', 'log_CommNums' => 'ASC'), //自定义order
)
===== 1.6版本及更早的语法 =====
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));}