# adv 站點模塊標簽
- [站點模塊標簽](#_1)
- [簡單示例](#_4)
- [參數](#_14)
- [獲取圖集](#_42)
- [獲取多媒體](#_89)
- [獲取HTML](#HTML_118)
- [獲取內容數據](#_134)
- [獲取文字鏈接](#_142)
## 站點模塊標簽
站點模塊標簽調用的是后臺站點模塊數據,支持圖集,多媒體,HTML內容,內容數據模塊。
## 簡單示例
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>adv name<span class="token">=</span><span class="token4">"home-banner"</span><span class="token1">}</span>
<span class="token"><</span>div style<span class="token">=</span><span class="token4">"background-image:url({$item.image});"</span><span class="token">></span>
數組的索引:<span class="token1">{</span>$key<span class="token1">}</span>
循環變量:<span class="token1">{</span>$i<span class="token1">}</span>,第幾次循環,從<span class="token3">1</span>開始。
<span class="token"><</span><span class="token">/</span>div<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>adv<span class="token1">}</span>
```
```
## 參數
> HkCms\_v2.1.210909之后版本itemid獲取的是排序序號。以添加圖集時的順序,從1開始
參數名稱可選值默認值是否必填說明name--是模塊標識,即后臺站點模塊里面的標識,每一個模塊都有標識itemid---模塊子項序號,用于顯示特定圖集、視頻cache-3600秒-緩存時間,默認3600秒id-$item-指定循環里的變量名,例如id='obj',模板調用如:{$item.title} 變成 {$obj.title}empty---為空的時候輸出提示,支持傳入htmlcurrentstyle-active-指定選中的圖片,class名稱具體看下面示例current-1-指定第幾個選中,默認active class給到第一個num格式為數字,或傳入變量--限制數量- `name`,模塊唯一標識,值為站點模塊添加時所填寫的標識,如下圖所示

- `currentstyle`,選中的class,例如class等于active,假設第二張圖片為加載頁面后首先看到的,那么current="2",第二張圖集currentstyle里面就有值為active。控制哪個圖片有active就首先顯示出來。
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>adv name<span class="token">=</span><span class="token4">"home_banner"</span> currentstyle<span class="token">=</span><span class="token4">"active"</span> current<span class="token">=</span><span class="token4">"2"</span><span class="token1">}</span>
<span class="token5">// 只有第二張才有currentstyle才有值,這里是文字演示,具體的要根據你的輪播圖插件來。</span>
<span class="token"><</span>a href<span class="token">=</span><span class="token4">"{$item.url}"</span> class<span class="token">=</span><span class="token4">"{$item.currentstyle}"</span><span class="token">></span><span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>adv<span class="token1">}</span>
```
```
## 獲取圖集
假設獲取默認演示數據的`home_banner`標識的圖集
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>adv name<span class="token">=</span><span class="token4">"home_banner"</span><span class="token1">}</span>
圖片:<span class="token1">{</span>$item<span class="token1">.</span>image<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
圖集標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
圖集描述:<span class="token1">{</span>$item<span class="token1">.</span>notes<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
跳轉地址:<span class="token1">{</span>$item<span class="token1">.</span>url<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
a標簽跳轉方式:<span class="token1">{</span>$item<span class="token1">.</span>target<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
選中的class:<span class="token1">{</span>$item<span class="token1">.</span>currentstyle<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>adv<span class="token1">}</span>
```
```
a標簽跳轉方式由添加圖集時是否開啟新窗口打開,開啟后target就會等于:target=\_blank。
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>adv name<span class="token">=</span><span class="token4">"home_banner"</span><span class="token1">}</span>
<span class="token"><</span>a href<span class="token">=</span><span class="token4">"{$item.url}"</span> <span class="token1">{</span>$item<span class="token1">.</span>target<span class="token1">}</span><span class="token">></span><span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>adv<span class="token1">}</span>
```
```
結果示例
```
<pre class="calibre16">```
<span class="token"><</span>a href<span class="token">=</span><span class="token4">"#"</span> target<span class="token">=</span><span class="token4">"_blank"</span><span class="token">></span>宣傳視頻<span class="token"><</span><span class="token">/</span>a<span class="token">></span>
```
```
只獲取第二張圖片,使用itemid參數
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>adv name<span class="token">=</span><span class="token4">"home_banner"</span> itemid<span class="token">=</span><span class="token4">"2"</span><span class="token1">}</span>
<span class="token"><</span>img src<span class="token">=</span><span class="token4">"image"</span><span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>adv<span class="token1">}</span>
```
```
**常用字段說明**
注意:其中`$item`變量根據id參數影響,默認是:$item
字段名說明調用方式type類型,1=圖集,2=多媒體,3=html,4=內容數據,5=文字鏈接{$item.type}title圖集里面的標題{$item.title}image圖片地址{$item.image}url跳轉地址{$item.url}notes描述{$item.notes}weigh排序{$item.weigh}currentstyleclass值,選中的圖片才有值{$item.currentstyle}target標簽跳轉方式{$item.target}recommend一維數組,圖集組的信息-name圖集組的標識名稱{$[item.recommend.name](http://item.recommend.name)}remark圖集組標題{$item.recommend.remark}## 獲取多媒體
基本與圖集使用一致,唯一的區別是資源地址是content字段
```
<pre class="calibre16">```
<span class="token5">// 假設多媒體標識名叫video,那么如下獲取</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>adv name<span class="token">=</span><span class="token4">"video"</span><span class="token1">}</span>
資源地址:<span class="token1">{</span>$item<span class="token1">.</span>content<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
描述:<span class="token1">{</span>$item<span class="token1">.</span>notes<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
跳轉地址:<span class="token1">{</span>$item<span class="token1">.</span>url<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
a標簽跳轉方式:<span class="token1">{</span>$item<span class="token1">.</span>target<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
選中的class:<span class="token1">{</span>$item<span class="token1">.</span>currentstyle<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>adv<span class="token1">}</span>
```
```
**常用字段說明**
注意:其中`$item`變量根據id參數影響,默認是:$item
字段名說明調用方式type類型,1=圖集,2=多媒體,3=html,4=內容數據,5=文字鏈接{$item.type}title多媒體類型標題{$item.title}content資源地址{$item.image}url跳轉地址{$item.url}notes描述{$item.notes}weigh排序{$item.weigh}currentstyleclass值,選中的圖片才有值{$item.currentstyle}target標簽跳轉方式{$item.target}recommend一維數組,組的信息-name組的標識名稱{$[item.recommend.name](http://item.recommend.name)}remark組的標題{$item.recommend.remark}## 獲取HTML
假設HTML標識名叫`links`,那么如下獲取
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>adv name<span class="token">=</span><span class="token4">"links"</span><span class="token1">}</span>
<span class="token1">{</span>$item<span class="token1">.</span>content<span class="token1">}</span> <span class="token5">// 輸出HTML</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>adv<span class="token1">}</span>
```
```
**常用字段說明**
注意:其中`$item`變量根據id參數影響,默認是:$item
字段名說明調用方式content資源地址{$item.image}recommend一維數組,組的信息-name組的標識名稱{$[item.recommend.name](http://item.recommend.name)}remark組的標題{$item.recommend.remark}## 獲取內容數據
字段是根據選擇的模型而定的,字段名可前往模型管理》字段管理里面設置。
獲取內容數據示例:
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>adv name<span class="token">=</span><span class="token4">"ceshi"</span><span class="token1">}</span>
文檔標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>adv<span class="token1">}</span>
```
```
## 獲取文字鏈接
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>adv name<span class="token">=</span><span class="token4">"link"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
描述:<span class="token1">{</span>$item<span class="token1">.</span>notes<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
跳轉地址:<span class="token1">{</span>$item<span class="token1">.</span>url<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
a標簽跳轉方式:<span class="token1">{</span>$item<span class="token1">.</span>target<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
選中的class:<span class="token1">{</span>$item<span class="token1">.</span>currentstyle<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>adv<span class="token1">}</span>
```
```
**常用字段說明**
注意:其中`$item`變量根據id參數影響,默認是:$item
字段名說明調用方式title標題{$item.title}url跳轉地址{$item.url}notes描述{$item.notes}weigh排序{$item.weigh}currentstyleclass值,選中的圖片才有值{$item.currentstyle}target標簽跳轉方式{$item.target}recommend一維數組,圖集組的信息-name圖集組的標識名稱{$[item.recommend.name](http://item.recommend.name)}remark圖集組標題{$item.recommend.remark}
- 簡介
- 下載與安裝配置
- 下載
- 虛擬主機安裝
- 百度云虛擬主機
- 創業云虛擬主機
- Linux下寶塔安裝
- 寶塔一鍵部署
- Windows下寶塔安裝
- phpEnv下安裝
- phpStudy下安裝
- 偽靜態(url重寫)
- 安裝系統
- 調試模式與env文件
- 重新安裝與安裝文件說明
- 后臺使用幫助
- 后臺入口文件
- 首頁面板
- 配置中心
- 站點配置
- SEO設置
- SEO設置-靜態生成
- 文檔屬性
- 站點模塊
- V2.2.2版本 -
- V2.2.3版本 +
- 模型管理
- 欄目管理
- 字段類型與組件
- 前言
- 前端組件
- 驗證規則
- text 單行文本
- textarea 多行文本
- radio 單選
- checkbox 復選
- select 下拉列表
- selects下拉列表(多)
- selectpage 動態下拉
- editor編輯器
- image圖片
- images圖片(多)
- number數字
- date日期
- datetime日期和時間
- downfile文件上傳
- downfiles文件上傳(多)
- array 數組(鍵值對)
- 內容管理
- 自定義URL
- 多語言
- 界面多語言
- 內容多語言
- 多語言URL地址
- 附件管理
- 應用中心
- 標簽語法
- 標簽使用必讀
- 列表標簽
- content 內容列表標簽
- contentpage 內容列表分頁
- wfpage 瀑布流分頁
- filter 篩選標簽
- order 排序標簽
- 內容標簽
- guestbook 留言(表單)標簽(廢棄)
- form 表單標簽
- pre 上一篇標簽
- next 下一篇標簽
- prenext 上一篇下一篇(高級)標簽
- fileinfo 獲取附件信息(文件下載)
- 內容分頁
- raw 格式化編輯器文本(即將廢棄)
- 全局標簽
- seo 標簽
- channel 欄目標簽
- arcone 獲取單條文檔
- breadcrumb 面包屑導航標簽
- adv 站點模塊標簽
- date 日期格式化標簽
- substr字符(標題)截取標簽
- volist 循環標簽
- language 獲取語言列表標簽
- query 查詢數據庫內容
- include 導入模板文件標簽
- 原生PHP與php標簽
- map生成位置地圖
- thumb 生成縮略圖
- addons 插件檢測
- 標簽管理
- taglist標簽(獲取標簽列表)
- tagarclist根據標簽獲取文章內容列表
- 導入標簽
- 模板開發
- 1. 創建模板
- 2. 模板目錄結構
- 3. 模板描述文件(重要) info.ini
- 4. 變量輸出格式
- 4. 模板變量
- 5. 獲取站點配置
- 6. 模板界面多語言
- 7. 模板靜態目錄及調用靜態文件
- 8. 模板定義插件事件
- 9. 模板搜索頁
- 10. 模板配置JSON
- 11. 導入演示數據
- 12. 卸載刪除演示數據
- 13. 模板文件打包
- 14. 整站源碼打包
- 插件開發
- 1. 創建插件
- 2. 目錄結構
- 3. 插件名稱類
- 4. 插件信息(info.ini)
- 5. 插件事件
- 6. 配置文件
- 7. install 安裝目錄
- 8. 創建菜單
- 9. 插件控制器
- 10. 插件視圖
- 10-1 插件主題化
- 11. 插件模型
- 12. 模型事件
- 13. 插件內置函數
- 13-1 插件函數庫
- 14. 插件多語言
- 15. 插件中間件
- 16. 插件路由
- 17. 插件驗證器
- 18. 標簽庫
- 19. 第三方類庫
- 20. 數據庫文件導入
- 插件打包
- 后臺前端使用幫助
- 二次開發幫助(更新中)
- 后臺前端開發幫助
- 路由(鏈接地址、訪問規則)
- URL訪問
- 路由定義
- URL生成
- 附錄
- 數據字典
- 助手函數庫