## 概述
> 在模板里循環輸出直接使用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