[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} |