## 概述
> 在模板里循环输出直接使用ThinkPHP的volist或foreach标签,循环输出的变量在模板里主要通过函数来调用,系统主要有apiItem、categoryItem、navItem这几个函数。
## 视频循环输出
item为多维数据列表,列表页、搜索页已经处理定义好了item,直接循环输出即可。如果需要在模板内调用API远程数据,则需要通过apiItem函数处理,具体请参考函数章节。
```
{volist name=":apiNew(10,1)" id="maccms"}
{$maccms.type_id} API站点的分类ID
{$maccms.type_name} API站点的分类名称
{$maccms.episode_status} 连载状态
{$maccms.episode_title} 连载标题
{$maccms.episode_all} 总集数
{$maccms.vod_id} 视频ID
{$maccms.vod_title} 视频标题
{$maccms.vod_name} 副标描述
{$maccms.vod_updatetime} 更新时间
{$maccms.vod_cover} 主封面
{$maccms.vod_cover2} 次封面
{$maccms.vod_cover3} 附加封面
{$maccms.vod_content} 简介(数组)
{$maccms.vod_language} 对白语言(数组)
{$maccms.vod_area} 地区(数组)
{$maccms.vod_actor} 主演(数组)
{$maccms.vod_director} 导演(数组)
{$maccms.play_list} 播放列表(数组)
{/volist}
```
也可以使用foreach标签来进行循环输出
```
{foreach $item as $maccms}
...参数同上
{/foreach}
```
## 导航循环输出
全站任意位置均可使用此函数调用后台设置的导航列表,相关参数请参才函数navItem。
```
{volist name=":navItem(['status'=>'normal'])" id="maccms"}
{$maccms.op_id} ID
{$maccms.navs_name} 导航名称
{$maccms.navs_parent} 导航父级ID
{$maccms.navs_target} 打开窗口方式
{$maccms.navs_link} 链接URL
{$maccms.navs_module} 内部模块的模型
{$maccms.navs_controll} 内部模块的控制器
{$maccms.navs_action} 内部模块的操作
{$maccms.navs_active} 导航高亮伪类名
{/volist}
```
## 分类循环输出
全站任意位置均可使用此函数调用后台设置的分类列表,相关参数请参才函数categoryItem。
```
{volist name=":categoryItem(['limit'=>10])" id="maccms"}
{$maccms.term_id} ID
{$maccms.term_name} 分类名称
{$maccms.term_slug} 分类伪静态别名
{$maccms.term_module} 分类所属应用模型
{$maccms.term_group} 分类分组信息
{$maccms.term_order} 权重
{$maccms.term_info} 分类描述
{$maccms.term_parent} 父级分类ID
{$maccms.term_count} 分类统计
{$maccms.term_tpl} 模板文件名
{$maccms.term_api_tid} API分类ID
{/volist}
```
## 播放列表循环输出
只能在播放页使用此标签,play_list为二维数组形式的数据列表,参数如下
```
{foreach name="play_list" item="playOne" key="playFrom"}
{$i} 分集标识
{$playFrom} 播放来源
{volist name="playOne" id="play"}
{:playUrl(['id'=>$vod_id,'ep'=>$i,'from'=>$playFrom])} 播放链接
{$play.play_title} 分集名称
{$play.play_cover} 分集预览图
{/volist}
{/foreach}
```
## 友情链接循环输出
全站任意位置均可使用后台配置的友情链接,需注意后台必须配置为正确的json格式。
```
{volist name=":json_decode(config('maccms.link_index'),true)" id="maccms" offset="0" length="12"}
{$maccms.title} 链接名称
{$maccms.url} 链接网址
{$maccms.describe} 链接描述
{$maccms.target|default='_blank'} 链接打开方式
{/volist}
```
## 底部链接循环输出
全站任意位置均可使用后台配置的底部链接,需注意后台必须配置为正确的json格式。
```
{volist name=":json_decode(config('maccms.link_footer'),true)" id="maccms" offset="0" length="12"}
{$maccms.title} 链接名称
{$maccms.url} 链接网址
{$maccms.describe} 链接描述
{$maccms.target|default='_blank'} 链接打开方式
{/volist}
```
## 首页轮播循环输出(电脑端)
全站任意位置均可使用后台配置的友情链接,需注意后台必须配置为正确的json格式。
```
{volist name=":json_decode(config('maccms.slide_index'),true)" id="maccms" offset="0" length="8"}
{$maccms.title} 名称
{$maccms.url} 网址
{$maccms.describe} 描述
{$maccms.image} 图片地址
{/volist}
```
## 首页轮播循环输出(移动端)
全站任意位置均可使用后台配置的友情链接,需注意后台必须配置为正确的json格式。
```
{volist name=":json_decode(config('maccms.slide_index_m'),true)" id="maccms" offset="0" length="8"}
{$maccms.title} 名称
{$maccms.url} 网址
{$maccms.describe} 描述
{$maccms.image} 图片地址
{/volist}
```
- 序言
- 功能列表
- 环境配置
- 安装升级
- 后台管理
- 建站步骤
- 页面结构
- 首页
- 分类页
- 播放页
- 搜索页
- 聚合页-最新
- 聚合页-主演
- 聚合页-导演
- 聚合页-年份
- 聚合页-语种
- 模板开发
- 全局标签
- 首页标签
- 分类页标签
- 播放页标签
- 搜索页标签
- 聚合页-最新
- 聚合页-主演
- 聚合页-导演
- 聚合页-年份
- 聚合页-语种
- 数据调用
- 助手函数
- apiTermId
- apiTermSlug
- apiTermIdLimit
- apiTermIdArgs
- apiTerm
- apiSearch
- apiNew
- apiHour
- apiType
- apiField
- apiItem
- apiDetail
- navItem
- categoryItem
- categoryId
- categorySlug
- categoryMeta
- categoryUrl
- playUrl
- imageUrl
- colorRand
- typeId2termId
- typeId2termSlug
- maccmsTrim
- maccmsDate