站点模块标签
站点模块标签调用的是后台站点模块数据,支持图集,多媒体,HTML内容,内容数据模块。
简单示例
{hkcms:adv name="home-banner"}<div style="background-image:url({$item.image});">数组的索引:{$key}循环变量:{$i},第几次循环,从1开始。</div>{/hkcms:adv}
参数
HkCms_v2.1.210909之后版本itemid获取的是排序序号。以添加图集时的顺序,从1开始
参数名称 | 可选值 | 默认值 | 是否必填 | 说明 |
---|---|---|---|---|
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