全方位站长技能、SEO优化学习平台
当前位置:网站首页 > Zblog笔记 > 正文

Zblog内置GetList 函数详细介绍

作者:admin发布时间:2024-06-01分类:Zblog笔记浏览:5166


温馨提示:手机扫码可阅读当前文章!
文章简介:通过GetList可以获取自定义的文章列表,如指定分类的最新文章、置顶文章等等1.7新版本的语法及参数$result = GetList(array('count'=>10)) //返回a...

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

1.7新版本的语法及参数


Zblog内置GetList 函数详细介绍  第1张

$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$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] => 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>

欢迎您,来自美国–弗吉尼亚州–劳登县–阿什本的朋友,您的IP:3.236.112.101,您的网络:Amazon数据中心


Zblog笔记排行
随机推荐
猜你喜欢

服务热线

1888888888

要发发发发发发

站长微信公众号

站长微信公众号

分享:

支付宝

微信