Z-Blog主页
Z-Wiki
应用中心
菠萝阁
ZBlogger
Z5加密
跳至内容
Z-Blog Wiki
Z-Blog官方文库
用户工具
登录
站点工具
搜索
工具
显示页面
修订记录
最近更改
媒体管理器
网站地图
登录
>
最近更改
媒体管理器
网站地图
您在这里:
Z-Blog & Z-BlogPHP
»
Z-BlogPHP
»
应用开发指南
»
Z-BlogPHP 辅助函数列表
»
GetList 函数
zblogphp:development:functions:getlist
本页面只读。您可以查看源文件,但不能更改它。如果您觉得这是系统错误,请联系管理员。
====== GetList 函数====== 通过GetList可以获取自定义的文章列表,如指定分类的最新文章、置顶文章等等 ===== 1.7新版本的语法及参数 ===== <code php> $result = GetList(array('count'=>10)) //返回array(Post类型) 或是 空array() </code> array参数如下 <code php> array( 'count' => 10, //(可省略) 'cate' => 1, //(可省略) 'auth' => 2, //(可省略) 'date' => '2020-1', //(可省略) 'tags' => 'abc', //(可省略) 'search' => 's', //(可省略) '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表的记录 (可省略) ) </code> ===== 1.6版本及更早的语法 ===== <code php> Array GetList($count = 10, $cate = null, $auth = null, $date = null, $tags = null, $search = null, $option = null) </code> ===== 调用参数 ===== ^参数类型 ^参数 ^ 默认值 ^描述 ^ |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参数可指定更多配置选项,参考如下 <code php> $option = array ( "only_ontop" => true // "only_not_ontop" => true "has_subcate" => true //输出子分类文章 "is_related" => $article->ID //输出与指定文章具有相同tag的文章列表,剔除指定ID的文章,如当前文章ID($article->ID) ); </code> ===== 返回值 ===== 返回指定的文章列表数组,默认返回10条最近发表的文章,结构如下: <code php> Array ( [0] => Post Object0 [1] => Post Object1 ) </code> ===== 代码示例 ===== ==== 例1 ==== 获取10条最近发表的文章 <code php> $array=Getlist(); </code> ==== 例2 ==== 获取分类ID为3下的10条最近发表的文章 <code php> $array=Getlist(10,3); </code> ==== 例3 ==== 获取文章中使用标签ID=1或标签名="abc"的列表 <code php> $array=Getlist(10,null,null,null,array($zbp->GetTagByID(1),$zbp->GetTagByAliasOrName('abc'))); </code> ==== 例4 ==== 搜索正文或标题内容里含有'abc'的10条文章 <code php> $array=Getlist(10,null,null,null,null,'abc'); </code> ==== 例5 ==== 搜索$article的相关文章(ZC_RELATEDLIST_COUNT选项默认为10) <code php> $array=GetList($zbp->option['ZC_RELATEDLIST_COUNT'],null,null,null,null,null,array('is_related'=>$article->ID)); </code> 在模板中,获取并输出获取到的相关文章代码参考如下 <code php> {$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> </code>
zblogphp/development/functions/getlist.1609396758.txt
· 最后更改: 2020/12/31 14:39 由
zx.asd
页面工具
显示页面
修订记录
页面重命名
回到顶部