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

- `currentstyle`,選中的class,例如class等于active,假設第二張圖片為加載頁面后首先看到的,那么current="2",第二張圖集currentstyle里面就有值為active。控制哪個圖片有active就首先顯示出來。
~~~
{hkcms:adv name="home_banner" currentstyle="active" current="2"}
// 只有第二張才有currentstyle才有值,這里是文字演示,具體的要根據你的輪播圖插件來。
<a href="{$item.url}" class="{$item.currentstyle}">{$item.title}</a>
{/hkcms:adv}
~~~
## 獲取圖集
假設獲取默認演示數據的`home_banner`標識的圖集
~~~
{hkcms:adv name="home_banner"}
圖片:{$item.image} <br>
圖集標題:{$item.title} <br>
圖集描述:{$item.notes} <br>
跳轉地址:{$item.url} <br>
a標簽跳轉方式:{$item.target} <br>
選中的class:{$item.currentstyle} <br>
{/hkcms:adv}
~~~
a標簽跳轉方式由添加圖集時是否開啟新窗口打開,開啟后target就會等于:target=_blank。
~~~
{hkcms:adv name="home_banner"}
<a href="{$item.url}" {$item.target}>{$item.title}</a>
{/hkcms:adv}
~~~
結果示例
~~~
<a href="#" target="_blank">宣傳視頻</a>
~~~
只獲取第二張圖片,使用itemid參數
~~~
{hkcms:adv name="home_banner" itemid="2"}
<img src="image">
{/hkcms:adv}
~~~
**常用字段說明**
注意:其中`$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} |
|currentstyle | class值,選中的圖片才有值 | {$item.currentstyle} |
|target | 標簽跳轉方式 | {$item.target} |
|recommend | 一維數組,圖集組的信息 | - |
|name | 圖集組的標識名稱 | {$item.recommend.name} |
|remark | 圖集組標題 | {$item.recommend.remark} |
## 獲取多媒體
基本與圖集使用一致,唯一的區別是資源地址是content字段
~~~
// 假設多媒體標識名叫video,那么如下獲取
{hkcms:adv name="video"}
資源地址:{$item.content} <br>
標題:{$item.title} <br>
描述:{$item.notes} <br>
跳轉地址:{$item.url} <br>
a標簽跳轉方式:{$item.target} <br>
選中的class:{$item.currentstyle} <br>
{/hkcms:adv}
~~~
**常用字段說明**
注意:其中`$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} |
|currentstyle | class值,選中的圖片才有值 | {$item.currentstyle} |
|target | 標簽跳轉方式 | {$item.target} |
|recommend | 一維數組,組的信息 | - |
|name | 組的標識名稱 | {$item.recommend.name} |
|remark | 組的標題 | {$item.recommend.remark} |
## 獲取HTML
假設HTML標識名叫`links`,那么如下獲取
~~~
{hkcms:adv name="links"}
{$item.content} // 輸出HTML
{/hkcms:adv}
~~~
**常用字段說明**
注意:其中`$item`變量根據id參數影響,默認是:$item
| 字段名 | 說明 | 調用方式 |
| --- | --- | --- |
|content | 資源地址 | {$item.image} |
|recommend | 一維數組,組的信息 | - |
|name | 組的標識名稱 | {$item.recommend.name} |
|remark | 組的標題 | {$item.recommend.remark} |
## 獲取內容數據
字段是根據選擇的模型而定的,字段名可前往模型管理》字段管理里面設置。
獲取內容數據示例:
~~~
{hkcms:adv name="ceshi"}
文檔標題:{$item.title}
{/hkcms:adv}
~~~
## 獲取文字鏈接
~~~
{hkcms:adv name="link"}
標題:{$item.title} <br>
描述:{$item.notes} <br>
跳轉地址:{$item.url} <br>
a標簽跳轉方式:{$item.target} <br>
選中的class:{$item.currentstyle} <br>
{/hkcms:adv}
~~~
**常用字段說明**
注意:其中`$item`變量根據id參數影響,默認是:$item
| 字段名 | 說明 | 調用方式 |
| --- | --- | --- |
|title | 標題 | {$item.title} |
|url | 跳轉地址 | {$item.url} |
|notes | 描述 | {$item.notes} |
|weigh | 排序 | {$item.weigh} |
|currentstyle | class值,選中的圖片才有值 | {$item.currentstyle} |
|target | 標簽跳轉方式 | {$item.target} |
|recommend | 一維數組,圖集組的信息 | - |
|name | 圖集組的標識名稱 | {$item.recommend.name} |
|remark | 圖集組標題 | {$item.recommend.remark} |
- 簡介
- 下載與安裝配置
- 下載
- 虛擬主機安裝
- 虛擬主機必讀
- 百度云虛擬主機
- 創業云虛擬主機
- Linux下寶塔安裝
- 寶塔一鍵部署
- Windows下寶塔安裝
- phpEnv下安裝
- phpStudy下安裝
- 偽靜態(url重寫)
- 安裝系統
- 調試模式與env文件
- 重新安裝與安裝文件說明
- 后臺使用幫助
- 后臺入口文件
- 首頁面板
- 配置中心
- 站點配置
- 郵件配置
- 附件配置
- 應用中心配置
- 前臺URL規則配置
- SEO設置
- SEO設置-靜態生成
- 文檔屬性
- 站點模塊
- V2.2.2版本 -
- V2.2.3版本 +
- 模型管理
- 欄目管理
- 字段類型與組件
- 前言
- 前端組件
- 動態下拉(selectpage)
- 驗證規則
- 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 獲取語言列表標簽
- lang 特定語言下顯示內容標簽
- 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生成
- 會員管理
- 前臺限制頁面登錄或權限控制
- 附錄
- 數據字典
- 助手函數庫
- API接口