JEECMSv8系统标签详解
V8 JEECMS标签使用详解
热词[@cms_searchword]
[@cms_searchword_list word='' siteId='1' recommend='2' orderBy='4' count='5']
[#list tag_list as word]
${word.name!}
[/#list]
[/@cms_searchword_list]
说明：
word 词汇
recommend 推荐 1, 非推荐 0 全部 2
siteId 站点ID
orderBy 排序 1搜索次数降序 2搜索次数升序 3排序降序 4排序升序
count 列表个数
参数除了count都是非必选
截取 [@cms_cut]
[@text_cut s=a.title len=’20’ append=”…”/]
标签介绍
参数详解：
s：截取字符串长度
len：保留字符的长度
append：保留字段以后的追加字符以。。。。显示
作用：截取过长的字符串，如标题标题太长了可以。。。。表示
具体例子：
[@cms_content_list channelId='60' count='5' titLen='20' append='...' channelOption='1' dateFormat='yyyy-MM-dd']
[#list tag_list as a]
[@text_cut s=a.title len=titLenappend=append/]
[/#list]
[/@cms_content_list]
友情链接 [@cms_friendink_list]
[@cms_friendlink_list ctgId='2' siteId=site.id]
标签介绍
参数详解
ctgId：链接类别
siteId：站点ID
文字链接
[@cms_friendlink_list ctgId='1']
[#list tag_list as link]
[/#list]
[/@cms_friendlink_list]
链接网址：${link.domain}
链接名称:${link.name}
图片链接
[@cms_friendlink_list ctgId='2']
[#list tag_list as link] [/#list]
[/@cms_friendlink_list]
链接的LOGO:${link.logo!site.defImg}
友情链接分类 [@cms_friendlink_ctg_list]
[@cms_friendlink_ctg_list siteId='1']
[#list tag_list as ctg]
${ctg.name}
[/#list]
[/@cms_friendlink_ctg_list]
链接分类名: ${ctg.name}
Tag关键词分页 [@cms_tag_page]
[@cms_tag_page count='8']
[#list tag_list as tag]
${tag.name}[#if tag_has_next]|[/#if][/#list]
[@cms_pagination sysPage='1'/]
[/@cms_tag_page]
参数详解：
count： 每页数
Tag关键词列表 [@cms_tag_list]
[@cms_tag_list count='8']
[#list tag_list as tag]${tag.name}[#if tag_has_next]|[/#if][/#list]
[/@cms_tag_list]
参数详解
count：显示个数
作用：显示tag列表
全文检索分页 [@cms_lucene_page]
[@cms_lucene_page q=q channelId=channelId startDate=startDate endDate=endDate descLen='170' append='...' count='10' ]
搜索结果分页标签
参数详解
q: 搜索关键字
siteId:站点ID
channeled:栏目ID
startDate:：开始时间
endDate:结束时间
count 分页数
作用：对搜索结果分页
具体例子：
[#if q??]
[@cms_lucene_page q=q channelId=channelId startDate=startDate endDate=endDate descLen='170' append='...' count='10' ]
[#list tag_list as s]
[#if s.txt??]
[#assign bb=s.txt?replace("<(S*?)[^>]*>.*?|<.*? />","","ri")?replace(" ","","ri")/]
[@text_cut s=bb?replace('${q!}', "${q!}") len=descLen append=append/]
[/#if]
[/#list]
[/@cms_lucene_page]
全文检索列表 [@cms_lucene_list]
搜索结果列表标签
参数详解
q: 搜索关键字
siteId:站点ID
channeled:栏目ID
startDate:：开始时间
endDate:结束时间
作用：对搜索结果列表
具体例子：
[#if q??]
[@cms_lucene_list q=q channelId=channelId descLen='100' append='...' count='4' sysPage='1' ]
您搜索的“${q!}”，共有${tag_list?size} 条查询结果，[@process_time/]
[#list tag_list as s]
[/#list]
[/@cms_lucene_list]
[/#if]
包含页面 [@cms_include]
页面模板包含标签：
作用：把做好的页面引入到另外一个页面上去，一般是整个网站的一些公共部分，每个网页都需要的，比如页头，页脚。
具体例子：
示例：
[#include "../include/页头顶栏.html"/]
[#include "../include/页头导航栏.html"/]
留言分类 [@cms_guestbook_ctg_list]
[@cms_guestbook_ctg_list siteId= ‘1’]
[#list tag_list as ctg]
${ctg.name!}
[/#list]
[/@cms_guestbook_ctg_list]
参数详解
siteId:站点ID
输出： 分类名 ${ctg.name!}
留言分页 [@cms_guestbook_page]
[@cms_guestbook_page siteId= ‘1’ ctgId=‘1’ recommend=’1’ checked=’1’ orderBy=’0’]
[#list tag_list as g]
标题：${g.titleHtml!}
内容：${g.contentHtml!}
回复内容：${g.replyHtml!}
留言时间：${ g.createTime?string(“yyyy-MM-dd：HH:mm:ss”) }
回复时间：
[#if g. replayTime?? ]${ g. replayTime?string(“yyyy-MM-dd：HH:mm:ss”) }[/#if]
留言者:${g. member.username!}
回复者：[#if g.admin??]${g. admin .username!}[/#if]
[/#list]
[/@cms_guestbook_page]
参数详解
siteId:站点ID
ctgId:分类ID，非必选参数
recommend：是否推荐，若是1 则选择推荐的 若是0 则是非推荐的，若是没有该参数则是全部
checked：是否审核的，若是1 则审核通过的 若是没有该参数则是全部，非必选参数
orderBy：排列顺序。0：按留言时间降序；1：按留言时间升序。默认降序，非必选参数
留言列表 [@cms_guestbook_list]
[@cms_guestbook_list]参数雷同[@cms_guestbook_page]标签，并且输出调用也一致，只是不能用分页
[@cms_pagination sysPage='1'/]分页标签不能用于[@cms_guestbook_list]标签体内
内容分页 [@cms_content_page]
内容列表分页标签：
参数详解：
tagId: TAG ID 允许多个TAG ID，用“，”分开。和tagNames之间二选一，ID优先级更高
tagName: TAG NAME 允许多个TAG NAME ，用“，”分开
topicId：专题ID
channelId : 栏目ID，允许多个栏目ID，用“，”分开。和channelpath之间二选一，ID优先级更高
channelPath : 栏目路径，允许多个栏目路径，用“，”分开
channelOption : 栏目选项，用于单栏目情况下。 0 ：自身栏目 1 ：包含子栏目 2: 包含副栏目
siteId：站点ID，可选，允许多个站点ID，用“，”分开
以上几个参数的优先级是：
tagId >tagName> topicId > channelId > channelPath >siteId
也就是如果同时出现以上几个参数，优先级高的参数有效，优先级低的参数无效，若是上面的参数均没有，则默认取的是当前站点的数据
typeId：类型ID，可选，允许多个类型ID，用“，”分开
recommend：是否推荐。 0 ：所有都推荐 1 ：推荐 2 ：不推荐，默认所有
title：标题，非必选
image：标题图片， 0 ：所有 1 ：有 2 ：没有。默认所有
count:每页多少条数据
orderBy :排序方式 0：ID降序 1：ID升序 2：发布时间降序 3：发布时间升序 4：固定级别降序，发布时间降序 5：固定级别降序，发布时间升序 6：日访问降序（推荐）7：周访问降序 8：月访问降序 9：总访问降序 10：日评论降序（推荐） 11：周评论降序 12：月评论降序 13：总评论降序 14：日下载降序（推荐）15：周下载降序 16：月下载降序 17：总下载降序 18：日顶降序（推荐） 19：周顶降序 20：月顶降序 21：总顶降序22:推荐降、发布降 23:推荐升、发布降
excludeId：不包含的文章ID，用于按tag查询相关文章，只有在tagId tagName参数有效，topicId channelId channelPath siteId参数下无效。
自定义字段查询
参数：s_param,o_param(o_param的值可以是start、end、like、eq、gt、gte、lt、lte)
参数详解：s_和o_是固定格式,s_param和o_param的param是自定义字段,
o_param的值介绍如下：
start 以o_param的值为开始的字符串
end 以o_param的值为结束的字符串
like 模糊查询o_param的值
eq相等，gt 大于、gte 大于或等于、lt小于、lte小于或等于
样例：s_price='50' o_price='gt'表示查询price自定义字段大于50的数据
标签系统内置模板应用（也是标签参数来选用样式）
参数 tpl:列表样式选择
0：不调用，使用标签的body；1：调用自定义模板；2：调用系统预定义模板；3：调用用户预定义模板。默认：0
style_list：文章列表显示样式，当tpl=2或者3 时有效，默认设置2，可选值有：
1-1 文字列表 1-2图文列表 1-3文字列表带点击率
2-1文字列表向上滚动 2-2图文列表向上滚动 2-3文字列表向左滚动 2-4图文列表向左滚动
3-1 3-2 3-3焦点图
内置样式其他参数
1-1文字列表
lineHeight：行高；【行高】
headMarkImg: 列表头图片；【图片地址】
headMark: 列表头编号；【1：小黑点；2：小红点；3：单箭头；4：双箭头】
datePosition: 日期位置；【1：后面左边；2：后面右边；3：前面】不能为空
bottomLine: 下划线；【0：无；1：有】不能为空。
ctgForm: 类别；【0：无；1：栏目；2：站点】不能为空
1-3文字列表带点击率
除了需要文字列表标签内置参数，还需要以下两个
view:访问量 1总访问量 2 月访问量 3周访问量 4日访问量
viewTitle:访问量数字之前的描述的词汇（例如：总访问量）
1-2图文列表
picWidth: 图片宽度；【按百分比计算（如为24.9；即每个图片占总宽度的24.9%，每行可放四张图片）】
picHeight: 每行图片显示高度；【按像素px计算】
picFloat: 图片是否左浮动；【0：否；1：是】
rightPadding: 图片右边距；【按像素px计算】
2-1图文列表或标题列表向上滚动
rollDisplayHeight: 显示区域高度；【按像素px计算】
rollLineHeight: 滚动区行高；【按像素px计算】
rollCols: 滚动列数；【一行中包含几列】
rollSpeed: 滚动速度；【滚动速度，值越小越快，最小为1】
rollSleepTime: 滚动停顿时间；【值越大停顿越久】
rollRows: 滚动行数；【一个滚动周期滚动的行数】
rollSpan: 滚动跨度；【一次滚动的像素，跨度越大，滚动就越快，但越不流畅】
isSleep: 是否停顿；【0：停顿；1：停顿】
2-2图文列表向上滚动
需要2-1参数还需要1-2参数
2-3文字列表向左滚动
rollSpeed: 滚动速度；【滚动速度，值越小越快，最小为1】
rollSpan: 滚动跨度；【一次滚动的像素，跨度越大，滚动就越快，但越不流畅】
2-4图文列表向左滚动
1-2图文列表属性和
rollSpeed: 滚动速度；【滚动速度，值越小越快，最小为1】
rollSpan: 滚动跨度；【一次滚动的像素，跨度越大，滚动就越快，但越不流畅】
rollLineHeight: 滚动区行高；【按像素px计算】
3-1 3-2 3-2 焦点图参数
focusType: 焦点图类型；【1；2；3】不能为空
flashWidth: flash宽度；【按像素px计算】不能为空。
flashHeight: flash高度；【按像素px计算】不能为空。
textHeight: 文本高度；【按像素px计算】不能为空。
内置标签样式通用属性
showTitleStyle：显示标题样式；【0：不显示；1：显示】
useShortTitle: 是否使用简短标题；【0：不使用；1：使用】
dateFormat: 日期格式；【java日期格式，如：yyyy-MM-dd】
titLen: 标题长度；【英文字母按半个计算】为空则不截断
target: 是否新窗口打开；【0：原窗口；1：新窗口】不能为空
作用：对显示的文章列表进行分页
具体例子：
[@cms_content_page channelId=channel.id count='4' sysPage=’1’ titLen='15' append='...' orderBy='2' dateFormat='MM-dd' channelOption='1']
[#list tag_pagination.list as a]
[/#list]
[/@cms_content_page]
内容列表 [@cms_content_list]
文章列表标签
参数除了包含 [@cms_content_page]相同的标签，新增了
参数ids: 允许多个文章ID，用","分开,如果标签用了ids参数，则
tagId tagName topicId channelId channelPath siteId这些参数无效
count参数变更为查询多少条数据
具体例子：
单篇内容 [@cms_content]
文章标签对象
参数详解：
id: 文章ID
next: 0 下一篇 1上一篇 ，非必选，若是没有该参数则找到具体某文章。
channelId:栏目ID 若是设置了栏目id，则上一篇下一篇是针对的栏目下的内容，若是没有设定则是本站内。
作用：显示某篇文章
具体例子：
上一篇：[@cms_content id=content.id next='1' channelId=channel.id][#if tag_bean??]${tag_bean.title}[#else]没有了[/#if][/@cms_content]
下一篇：[@cms_content id=content.id next='0' channelId=channel.id][#if tag_bean??]${tag_bean.title}[#else]没有了[/#if][/@cms_content]
单篇内容 [@cms_content]
文章标签对象
参数详解：
id: 文章ID
next: 0 下一篇 1上一篇 ，非必选，若是没有该参数则找到具体某文章。
channelId:栏目ID 若是设置了栏目id，则上一篇下一篇是针对的栏目下的内容，若是没有设定则是本站内。
作用：显示某篇文章
具体例子：
上一篇：[@cms_content id=content.id next='1' channelId=channel.id][#if tag_bean??]${tag_bean.title}[#else]没有了[/#if][/@cms_content]
下一篇：[@cms_content id=content.id next='0' channelId=channel.id][#if tag_bean??]${tag_bean.title}[#else]没有了[/#if][/@cms_content]
投票列表 [@cms_vote_list]
[@cms_vote_list siteId=’1’ count=’5’]
[#list tag_list as vote]
[@text_cut s=vote.title?html len=14 append='...' /] [#if vote.endTime??]${vote.endTime?string("yyyy-MM-dd")}[/#if]
[/#list]
[/@cms_vote_list]
参数详解：
siteId: 站点ID
count: 数量
作用：投票列表
投票 [@cms_vote]
[@cms_vote id=’1’siteId=’1’]
投票标签
参数详解：
id:投票ID 可以为空，为空则获取站点的默认投票
siteId:站点ID 默认为当前站点
作用：实现网络调查投票模块
具体例子：
[@cms_vote]
[#if !tag_bean??]
[#else]
[/#if]
[/@cms_vote]
投票对象属性：
title：标题
description:描述
startTime:开始时间
endTime：结束时间
subtopics：投票题目对象集合
records:投票记录对象集合
投票题目对象属性
isRadio 题目类型是否单选
isMulti 题目类型是否多选
isText 题目类型是否文本回复
title 题目标题
priority题目排序
voteItems 题目选项对象集合
voteReplys 文本类型题目回复对象集合
题目选项对象属性
title:题目选项对象标题
priority: 题目选项对象排序
picture：图片上传位置
voteCount:选项投票数
文本类型题目回复对象属性
reply：文本回复内容
专题分页 [@cms_topic_page]
专题分页标签
[@cms_topic_page channelId=’1’ recommend=’1’ count='2' descLen='50' append='...']
参数详解：
channelId:栏目ID 非必选
recommend：是否推荐 0全部 1推荐的 非必选
count :每页分页数
作用：对页面显示的专题列表进行分页
具体例子：
[@cms_topic_page count='2' descLen='50' append='...']
[#list tag_pagination.list as t]
[/#list]
[/@cms_topic_page]
专题对象属性
name：专题名称
shortName：简称
keywords：关键词
description：描述
titleImg：标题图
contentImg：内容图
priority：排序
recommend：是否推荐
专题列表 [@cms_topic_list]
专题列表标签
[@cms_topic_list channelId=’1’ recommend=’1’ count='2' descLen='50' append='...']
参数详解：
参数和cms_topic_page标签相同，只是cms_topic_list标签体内不能插入分页标签[@cms_pagination sysPage='1'/]
count：列表获取的专题数量
评论分页 [@cms_comment_page]
评论分页标签
[@cms_comment_page siteId =‘1’contentId=‘1’ greaterThen=‘0’ checked=‘1’ recommend =‘1’ count='6' orderBy='1 ']
参数详解：
siteId:站点id，非必选
contentId：内容ID，非必选
greaterThen: 评论内容最大支持大于多少，非必选
checked: 是否需要审核，1审核通过的，0 全部 非必选 默认全部
recommend:是否推荐，1推荐的，0 全部 非必选 默认全部
parentId:上级评论ID 优先级大于contentId若是出现了parentId ，contentId参数无效
count：分页数
orderBy:排列顺序：0 ：按评论时间降序 1 ：按评论时间升序。默认降序
若是parentId contentId siteId都没有，则默认当前站点的评论
在内容页模板中可以将contentId 设置成content.id，读取本内容下的评论
作用：对评论分页读取
具体例子：
评论对象属性
textHtml：评论内容
replayHtml：回复内容
ip:评论者ip地址
createTime：评论时间
replayTime：回复时间
ups：顶数
downs：踩数
recommend：是否推荐
checked：是否审核
replyCount：回复数
replayUser：回复用户对象 例如获取回复管理员用户名${c. replayUser.username!}
commentUser：评论用户对象 例如${c. commentUser.username!}
parent：父级评论对象 例如${c. parent.username!}
评论列表 [@cms_comment_list]
评论列表标签
[@cms_comment_list siteId =‘1’contentId=‘1’ greaterThen=‘0’ checked=‘1’ recommend =‘1’ count='6' orderBy='1 ']
参数和cms_comment_page标签一致，只是不能标签体内不能插入分页标签
具体例子：
[@cms_comment_list siteId='1' count='5' recommend='1' textLen='50' append='...']
[/@cms_comment_list]
单栏目 [@cms_channel]
栏目对象标签
[@cms_channel id='1' path=’news’ siteId=’1’]
参数详解：
id：栏目ID 若id参数不为空则另外两个参数无效
path：栏目路径 ，若id为空则根据站点id和path来获取栏目对象
siteId: 站点ID，存在时获取该站点栏目，不存在时获取当前站点栏目
具体例子：
[@cms_channel id='1']
${tag_bean.name}
[/@cms_channel]
栏目对象属性：
参考第二章的栏目对象可访问属性
分页 [@cms_ pagination]
分页标签：[@cms_pagination sysPage='1' userPage=’content’/]
参数详解：
sysPage:1系统预定义的分页模板，优先级大于userPage
userPage ：‘content’则获取模板下 style_page下面的content.html为分页页面
单模型 [@cms_model]
模型标签：[@cms_model id=’1’ path=’news’]
参数详解：
id：模型id
path:模型路径 ，两个参数用一个即可，id优先级高于path
模型对象属性
name：评论内容
path:模型路径
priority：模型排序
disabled：是否禁用
hasContent：是否有内容
def：是否默认
global：是否全站模型
items：模型字段对象集合
模型字段对象属性
field:字段 label：名称 priority 排序
defValue：默认值 optValue 可选项
datatype：字段类型：1 字符串文本 2整型文本 3浮点型文本 4文本区 5日期 6下拉列表 7复选框 8单选框 9附件 10图片
channel：[#if item.channel]栏目模型字段[#else]内容模型字段[/#if]
custom: [#if item. custom]自定义字段[#else]系统默认字段[/#if]
display：是否展示
required：是否必填
广告 [@cms_advertising]
模型标签：[@cms_advertising id=’1]
参数详解：
id：广告id，必选
广告对象属性
percent 转化率=点击数/展现数
name：名称
category：类型 image、flash、text、code 分别是图片、flash、文本、代码类型
code：广告代码，在category为code类型时候 该项有值
weight：权重
displayCount：展现次数
clickCount：点击次数
startTime：开始时间
endTime：结束时间
enabled：是否禁用
具体例子：
[@cms_advertising id='1']
[#if tag_bean??]
[#if tag_bean.category=="image"]
[#assign html]
[/#assign]
${html!}
[#elseif tag_bean.category=="flash"]
[#assign html]
[/#assign]
${html!}
[#elseif tag_bean.category=="text"]
[#assign html]
${(tag_bean.attr.text_title)!}
[/#assign]
${html!}
[#elseif tag_bean.category=="code"]
${tag_bean.code!}
[#else]
未知的广告类型：${tag_bean.category!}
[/#if]
[#else]
广告不存在"
[/#if]
[/@cms_advertising]
简单的调用方式
${base}/ad.jspx?id=1 调用具体某个广告
还可以按照广告版位来调用广告，这样可以实现按照区位来展现多个广告轮换展示
${base}/adspace.jspx？id=1 调用广告版位id为1的广告，若该区位有多个广告，将按照广告的权重来展示，若A广告权重2 B广告权重1 那么A广告出现次数大约是B的2倍
评分组 [@cms_score_group]
评分组标签：[@cms_score_group id=’1’]
参数详解
id：评分组id，非必选，没有则取默认组
具体例子：
[@cms_score_group]
[#if tag_bean??]
[#if tag_bean.id==2]
[#else]
[/#if]
[/#if]
[/@cms_score_group]
如果新增了其他评分组设定了默认评分组，需要实现效果
热词[@cms_searchword]
[@cms_searchword_list word='' siteId='1' recommend='2' orderBy='4' count='5']
[#list tag_list as word]
${word.name!}
[/#list]
[/@cms_searchword_list]
说明：
word 词汇
recommend 推荐 1, 非推荐 0 全部 2
siteId 站点ID
orderBy 排序 1搜索次数降序 2搜索次数升序 3排序降序 4排序升序
count 列表个数
参数除了count都是非必选
截取 [@cms_cut]
[@text_cut s=a.title len=’20’ append=”…”/]
标签介绍
参数详解：
s：截取字符串长度
len：保留字符的长度
append：保留字段以后的追加字符以。。。。显示
作用：截取过长的字符串，如标题标题太长了可以。。。。表示
具体例子：
[@cms_content_list channelId='60' count='5' titLen='20' append='...' channelOption='1' dateFormat='yyyy-MM-dd']
[#list tag_list as a]
[/#list]
[/@cms_content_list]
友情链接 [@cms_friendink_list]
[@cms_friendlink_list ctgId='2' siteId=site.id]
标签介绍
参数详解
ctgId：链接类别
siteId：站点ID
文字链接
[@cms_friendlink_list ctgId='1']
[#list tag_list as link]
[/#list]
[/@cms_friendlink_list]
链接网址：${link.domain}
链接名称:${link.name}
图片链接
[@cms_friendlink_list ctgId='2']
[#list tag_list as link]
[/@cms_friendlink_list]
链接的LOGO:${link.logo!site.defImg}
友情链接分类 [@cms_friendlink_ctg_list]
[@cms_friendlink_ctg_list siteId='1']
[#list tag_list as ctg]
${ctg.name}
[/#list]
[/@cms_friendlink_ctg_list]
链接分类名: ${ctg.name}
Tag关键词分页 [@cms_tag_page]
[@cms_tag_page count='8']
[#list tag_list as tag]
${tag.name}[#if tag_has_next]|[/#if][/#list]
[@cms_pagination sysPage='1'/]
[/@cms_tag_page]
参数详解：
count： 每页数
Tag关键词列表 [@cms_tag_list]
[@cms_tag_list count='8']
[#list tag_list as tag]${tag.name}[#if tag_has_next]|[/#if][/#list]
[/@cms_tag_list]
参数详解
count：显示个数
作用：显示tag列表
全文检索分页 [@cms_lucene_page]
[@cms_lucene_page q=q channelId=channelId startDate=startDate endDate=endDate descLen='170' append='...' count='10' ]
搜索结果分页标签
参数详解
q: 搜索关键字
siteId:站点ID
channeled:栏目ID
startDate:：开始时间
endDate:结束时间
count 分页数
作用：对搜索结果分页
具体例子：
[#if q??]
[@cms_lucene_page q=q channelId=channelId startDate=startDate endDate=endDate descLen='170' append='...' count='10' ]
您搜索的“${input!}”， 共有${tag_pagination.totalCount!}个结果
[#list tag_list as s]
[#if s.txt??]
[#assign bb=s.txt?replace("<(S*?)[^>]*>.*?|<.*? />","","ri")?replace(" ","","ri")/]
[@text_cut s=bb?replace('${q!}', "${q!}") len=descLen append=append/]
[/#if]
${s.ctgName}${s.releaseDate}浏览 ${s.views}
[/#list]
[@cms_pagination sysPage='1'/]
[/@cms_lucene_page]
全文检索列表 [@cms_lucene_list]
搜索结果列表标签
参数详解
q: 搜索关键字
siteId:站点ID
channeled:栏目ID
startDate:：开始时间
endDate:结束时间
作用：对搜索结果列表
具体例子：
[#if q??]
[@cms_lucene_list q=q channelId=channelId descLen='100' append='...' count='4' sysPage='1' ]
您搜索的“${q!}”，共有${tag_list?size} 条查询结果，[@process_time/]
[#list tag_list as s]
- [${s.ctgName}] ${s.title}
- [@text_cut s=s.description len=descLen append=append/]
- 来源：${s.origin!'本站原创'} 浏览次数：${s.views}次 发布时间： ${s.releaseDate}
[/#list]
[/@cms_lucene_list]
[/#if]
包含页面 [@cms_include]
页面模板包含标签：
作用：把做好的页面引入到另外一个页面上去，一般是整个网站的一些公共部分，每个网页都需要的，比如页头，页脚。
具体例子：
示例：
[#include "../include/页头顶栏.html"/]
[#include "../include/页头导航栏.html"/]
留言分类 [@cms_guestbook_ctg_list]
[@cms_guestbook_ctg_list siteId= ‘1’]
[#list tag_list as ctg]
${ctg.name!}
[/#list]
[/@cms_guestbook_ctg_list]
参数详解
siteId:站点ID
输出： 分类名 ${ctg.name!}
留言分页 [@cms_guestbook_page]
[@cms_guestbook_page siteId= ‘1’ ctgId=‘1’ recommend=’1’ checked=’1’ orderBy=’0’]
[#list tag_list as g]
标题：${g.titleHtml!}
内容：${g.contentHtml!}
回复内容：${g.replyHtml!}
留言时间：${ g.createTime?string(“yyyy-MM-dd：HH:mm:ss”) }
回复时间：
[#if g. replayTime?? ]${ g. replayTime?string(“yyyy-MM-dd：HH:mm:ss”) }[/#if]
留言者:${g. member.username!}
回复者：[#if g.admin??]${g. admin .username!}[/#if]
[/#list]
[@cms_pagination sysPage='1'/]
[/@cms_guestbook_page]
参数详解
siteId:站点ID
ctgId:分类ID，非必选参数
recommend：是否推荐，若是1 则选择推荐的 若是0 则是非推荐的，若是没有该参数则是全部
checked：是否审核的，若是1 则审核通过的 若是没有该参数则是全部，非必选参数
orderBy：排列顺序。0：按留言时间降序；1：按留言时间升序。默认降序，非必选参数
留言列表 [@cms_guestbook_list]
[@cms_guestbook_list]参数雷同[@cms_guestbook_page]标签，并且输出调用也一致，只是不能用分页
[@cms_pagination sysPage='1'/]分页标签不能用于[@cms_guestbook_list]标签体内
内容分页 [@cms_content_page]
内容列表分页标签：
参数详解：
tagId: TAG ID 允许多个TAG ID，用“，”分开。和tagNames之间二选一，ID优先级更高
tagName: TAG NAME 允许多个TAG NAME ，用“，”分开
topicId：专题ID
channelId : 栏目ID，允许多个栏目ID，用“，”分开。和channelpath之间二选一，ID优先级更高
channelPath : 栏目路径，允许多个栏目路径，用“，”分开
channelOption : 栏目选项，用于单栏目情况下。 0 ：自身栏目 1 ：包含子栏目 2: 包含副栏目
siteId：站点ID，可选，允许多个站点ID，用“，”分开
以上几个参数的优先级是：
tagId >tagName> topicId > channelId > channelPath >siteId
也就是如果同时出现以上几个参数，优先级高的参数有效，优先级低的参数无效，若是上面的参数均没有，则默认取的是当前站点的数据
typeId：类型ID，可选，允许多个类型ID，用“，”分开
recommend：是否推荐。 0 ：所有都推荐 1 ：推荐 2 ：不推荐，默认所有
title：标题，非必选
image：标题图片， 0 ：所有 1 ：有 2 ：没有。默认所有
count:每页多少条数据
orderBy :排序方式 0：ID降序 1：ID升序 2：发布时间降序 3：发布时间升序 4：固定级别降序，发布时间降序 5：固定级别降序，发布时间升序 6：日访问降序（推荐）7：周访问降序 8：月访问降序 9：总访问降序 10：日评论降序（推荐） 11：周评论降序 12：月评论降序 13：总评论降序 14：日下载降序（推荐）15：周下载降序 16：月下载降序 17：总下载降序 18：日顶降序（推荐） 19：周顶降序 20：月顶降序 21：总顶降序22:推荐降、发布降 23:推荐升、发布降
excludeId：不包含的文章ID，用于按tag查询相关文章，只有在tagId tagName参数有效，topicId channelId channelPath siteId参数下无效。
自定义字段查询
参数：s_param,o_param(o_param的值可以是start、end、like、eq、gt、gte、lt、lte)
参数详解：s_和o_是固定格式,s_param和o_param的param是自定义字段,
o_param的值介绍如下：
start 以o_param的值为开始的字符串
end 以o_param的值为结束的字符串
like 模糊查询o_param的值
eq相等，gt 大于、gte 大于或等于、lt小于、lte小于或等于
样例：s_price='50' o_price='gt'表示查询price自定义字段大于50的数据
标签系统内置模板应用（也是标签参数来选用样式）
参数 tpl:列表样式选择
0：不调用，使用标签的body；1：调用自定义模板；2：调用系统预定义模板；3：调用用户预定义模板。默认：0
style_list：文章列表显示样式，当tpl=2或者3 时有效，默认设置2，可选值有：
1-1 文字列表 1-2图文列表 1-3文字列表带点击率
2-1文字列表向上滚动 2-2图文列表向上滚动 2-3文字列表向左滚动 2-4图文列表向左滚动
3-1 3-2 3-3焦点图
内置样式其他参数
1-1文字列表
lineHeight：行高；【行高】
headMarkImg: 列表头图片；【图片地址】
headMark: 列表头编号；【1：小黑点；2：小红点；3：单箭头；4：双箭头】
datePosition: 日期位置；【1：后面左边；2：后面右边；3：前面】不能为空
bottomLine: 下划线；【0：无；1：有】不能为空。
ctgForm: 类别；【0：无；1：栏目；2：站点】不能为空
1-3文字列表带点击率
除了需要文字列表标签内置参数，还需要以下两个
view:访问量 1总访问量 2 月访问量 3周访问量 4日访问量
viewTitle:访问量数字之前的描述的词汇（例如：总访问量）
1-2图文列表
picWidth: 图片宽度；【按百分比计算（如为24.9；即每个图片占总宽度的24.9%，每行可放四张图片）】
picHeight: 每行图片显示高度；【按像素px计算】
picFloat: 图片是否左浮动；【0：否；1：是】
rightPadding: 图片右边距；【按像素px计算】
2-1图文列表或标题列表向上滚动
rollDisplayHeight: 显示区域高度；【按像素px计算】
rollLineHeight: 滚动区行高；【按像素px计算】
rollCols: 滚动列数；【一行中包含几列】
rollSpeed: 滚动速度；【滚动速度，值越小越快，最小为1】
rollSleepTime: 滚动停顿时间；【值越大停顿越久】
rollRows: 滚动行数；【一个滚动周期滚动的行数】
rollSpan: 滚动跨度；【一次滚动的像素，跨度越大，滚动就越快，但越不流畅】
isSleep: 是否停顿；【0：停顿；1：停顿】
2-2图文列表向上滚动
需要2-1参数还需要1-2参数
2-3文字列表向左滚动
rollSpeed: 滚动速度；【滚动速度，值越小越快，最小为1】
rollSpan: 滚动跨度；【一次滚动的像素，跨度越大，滚动就越快，但越不流畅】
2-4图文列表向左滚动
1-2图文列表属性和
rollSpeed: 滚动速度；【滚动速度，值越小越快，最小为1】
rollSpan: 滚动跨度；【一次滚动的像素，跨度越大，滚动就越快，但越不流畅】
rollLineHeight: 滚动区行高；【按像素px计算】
3-1 3-2 3-2 焦点图参数
focusType: 焦点图类型；【1；2；3】不能为空
flashWidth: flash宽度；【按像素px计算】不能为空。
flashHeight: flash高度；【按像素px计算】不能为空。
textHeight: 文本高度；【按像素px计算】不能为空。
内置标签样式通用属性
showTitleStyle：显示标题样式；【0：不显示；1：显示】
useShortTitle: 是否使用简短标题；【0：不使用；1：使用】
dateFormat: 日期格式；【java日期格式，如：yyyy-MM-dd】
titLen: 标题长度；【英文字母按半个计算】为空则不截断
target: 是否新窗口打开；【0：原窗口；1：新窗口】不能为空
作用：对显示的文章列表进行分页
具体例子：
[@cms_content_page channelId=channel.id count='4' sysPage=’1’ titLen='15' append='...' orderBy='2' dateFormat='MM-dd' channelOption='1']
[#list tag_pagination.list as a]
[@text_cut s=a.title len=titLen append=append/] [${a.date?string(dateFormat)}]
[/#list]
[/@cms_content_page]
内容列表 [@cms_content_list]
文章列表标签
参数除了包含 [@cms_content_page]相同的标签，新增了
参数ids: 允许多个文章ID，用","分开,如果标签用了ids参数，则
tagId tagName topicId channelId channelPath siteId这些参数无效
count参数变更为查询多少条数据
具体例子：
- [@text_cut s=a.title len=titLen append=append/]
[@cms_content_list count='10' titLen='15' orderBy='9' channelOption='1']
[#list tag_list as a]
[/#list]
[/@cms_content_list]
单篇内容 [@cms_content]
文章标签对象
参数详解：
id: 文章ID
next: 0 下一篇 1上一篇 ，非必选，若是没有该参数则找到具体某文章。
channelId:栏目ID 若是设置了栏目id，则上一篇下一篇是针对的栏目下的内容，若是没有设定则是本站内。
作用：显示某篇文章
具体例子：
单篇内容 [@cms_content]
文章标签对象
参数详解：
id: 文章ID
next: 0 下一篇 1上一篇 ，非必选，若是没有该参数则找到具体某文章。
channelId:栏目ID 若是设置了栏目id，则上一篇下一篇是针对的栏目下的内容，若是没有设定则是本站内。
作用：显示某篇文章
具体例子：
投票列表 [@cms_vote_list]
[@cms_vote_list siteId=’1’ count=’5’]
[#list tag_list as vote]
[@text_cut s=vote.title?html len=14 append='...' /] [#if vote.endTime??]${vote.endTime?string("yyyy-MM-dd")}[/#if]
[/#list]
[/@cms_vote_list]
参数详解：
siteId: 站点ID
count: 数量
作用：投票列表
投票 [@cms_vote]
[@cms_vote id=’1’siteId=’1’]
投票标签
参数详解：
id:投票ID 可以为空，为空则获取站点的默认投票
siteId:站点ID 默认为当前站点
作用：实现网络调查投票模块
具体例子：
[@cms_vote]
[#if !tag_bean??]
没有默认投票主题
[#else]
[/#if]
[/@cms_vote]
投票对象属性：
title：标题
description:描述
startTime:开始时间
endTime：结束时间
subtopics：投票题目对象集合
records:投票记录对象集合
投票题目对象属性
isRadio 题目类型是否单选
isMulti 题目类型是否多选
isText 题目类型是否文本回复
title 题目标题
priority题目排序
voteItems 题目选项对象集合
voteReplys 文本类型题目回复对象集合
题目选项对象属性
title:题目选项对象标题
priority: 题目选项对象排序
picture：图片上传位置
voteCount:选项投票数
文本类型题目回复对象属性
reply：文本回复内容
专题分页 [@cms_topic_page]
专题分页标签
[@cms_topic_page channelId=’1’ recommend=’1’ count='2' descLen='50' append='...']
参数详解：
channelId:栏目ID 非必选
recommend：是否推荐 0全部 1推荐的 非必选
count :每页分页数
作用：对页面显示的专题列表进行分页
具体例子：
[@cms_topic_page count='2' descLen='50' append='...']
[#list tag_pagination.list as t]
- ${t.name}
- [@text_cut s=t.description len=descLen append=append/]
[/#list]
[@cms_pagination sysPage='1'/]
[/@cms_topic_page]
专题对象属性
name：专题名称
shortName：简称
keywords：关键词
description：描述
titleImg：标题图
contentImg：内容图
priority：排序
recommend：是否推荐
专题列表 [@cms_topic_list]
专题列表标签
[@cms_topic_list channelId=’1’ recommend=’1’ count='2' descLen='50' append='...']
参数详解：
参数和cms_topic_page标签相同，只是cms_topic_list标签体内不能插入分页标签[@cms_pagination sysPage='1'/]
count：列表获取的专题数量
评论分页 [@cms_comment_page]
评论分页标签
[@cms_comment_page siteId =‘1’contentId=‘1’ greaterThen=‘0’ checked=‘1’ recommend =‘1’ count='6' orderBy='1 ']
参数详解：
siteId:站点id，非必选
contentId：内容ID，非必选
greaterThen: 评论内容最大支持大于多少，非必选
checked: 是否需要审核，1审核通过的，0 全部 非必选 默认全部
recommend:是否推荐，1推荐的，0 全部 非必选 默认全部
parentId:上级评论ID 优先级大于contentId若是出现了parentId ，contentId参数无效
count：分页数
orderBy:排列顺序：0 ：按评论时间降序 1 ：按评论时间升序。默认降序
若是parentId contentId siteId都没有，则默认当前站点的评论
在内容页模板中可以将contentId 设置成content.id，读取本内容下的评论
作用：对评论分页读取
具体例子：
评论对象属性
textHtml：评论内容
replayHtml：回复内容
ip:评论者ip地址
createTime：评论时间
replayTime：回复时间
ups：顶数
downs：踩数
recommend：是否推荐
checked：是否审核
replyCount：回复数
replayUser：回复用户对象 例如获取回复管理员用户名${c. replayUser.username!}
commentUser：评论用户对象 例如${c. commentUser.username!}
parent：父级评论对象 例如${c. parent.username!}
评论列表 [@cms_comment_list]
评论列表标签
[@cms_comment_list siteId =‘1’contentId=‘1’ greaterThen=‘0’ checked=‘1’ recommend =‘1’ count='6' orderBy='1 ']
参数和cms_comment_page标签一致，只是不能标签体内不能插入分页标签
具体例子：
[@cms_comment_list siteId='1' count='5' recommend='1' textLen='50' append='...']
- ${(c.commentUser.username)!"匿名网友"}对${c.content.title}评论道:
- [@text_cut s=c.textHtml len=textLen append=append/]
[#list tag_list as c]
[/#list]
[/@cms_comment_list]
单栏目 [@cms_channel]
栏目对象标签
[@cms_channel id='1' path=’news’ siteId=’1’]
参数详解：
id：栏目ID 若id参数不为空则另外两个参数无效
path：栏目路径 ，若id为空则根据站点id和path来获取栏目对象
siteId: 站点ID，存在时获取该站点栏目，不存在时获取当前站点栏目
具体例子：
[@cms_channel id='1']
[/@cms_channel]
栏目对象属性：
参考第二章的栏目对象可访问属性
分页 [@cms_ pagination]
分页标签：[@cms_pagination sysPage='1' userPage=’content’/]
参数详解：
sysPage:1系统预定义的分页模板，优先级大于userPage
userPage ：‘content’则获取模板下 style_page下面的content.html为分页页面
单模型 [@cms_model]
模型标签：[@cms_model id=’1’ path=’news’]
参数详解：
id：模型id
path:模型路径 ，两个参数用一个即可，id优先级高于path
模型对象属性
name：评论内容
path:模型路径
priority：模型排序
disabled：是否禁用
hasContent：是否有内容
def：是否默认
global：是否全站模型
items：模型字段对象集合
模型字段对象属性
field:字段 label：名称 priority 排序
defValue：默认值 optValue 可选项
datatype：字段类型：1 字符串文本 2整型文本 3浮点型文本 4文本区 5日期 6下拉列表 7复选框 8单选框 9附件 10图片
channel：[#if item.channel]栏目模型字段[#else]内容模型字段[/#if]
custom: [#if item. custom]自定义字段[#else]系统默认字段[/#if]
display：是否展示
required：是否必填
广告 [@cms_advertising]
模型标签：[@cms_advertising id=’1]
参数详解：
id：广告id，必选
广告对象属性
percent 转化率=点击数/展现数
name：名称
category：类型 image、flash、text、code 分别是图片、flash、文本、代码类型
code：广告代码，在category为code类型时候 该项有值
weight：权重
displayCount：展现次数
clickCount：点击次数
startTime：开始时间
endTime：结束时间
enabled：是否禁用
具体例子：
[@cms_advertising id='1']
[#if tag_bean??]
[#if tag_bean.category=="image"]
[#assign html]
[/#assign]
${html!}
[#elseif tag_bean.category=="flash"]
[#assign html]
[/#assign]
${html!}
[#elseif tag_bean.category=="text"]
[#assign html]
${(tag_bean.attr.text_title)!}
[/#assign]
${html!}
[#elseif tag_bean.category=="code"]
${tag_bean.code!}
[#else]
未知的广告类型：${tag_bean.category!}
[/#if]
[#else]
广告不存在"
[/#if]
[/@cms_advertising]
简单的调用方式
${base}/ad.jspx?id=1 调用具体某个广告
还可以按照广告版位来调用广告，这样可以实现按照区位来展现多个广告轮换展示
${base}/adspace.jspx？id=1 调用广告版位id为1的广告，若该区位有多个广告，将按照广告的权重来展示，若A广告权重2 B广告权重1 那么A广告出现次数大约是B的2倍
评分组 [@cms_score_group]
评分组标签：[@cms_score_group id=’1’]
参数详解
id：评分组id，非必选，没有则取默认组
具体例子：
[@cms_score_group]
[#if tag_bean??]
[#if tag_bean.id==2]
[#else]
0票
[#if item.imagePath??]
[/#if]
${item.name!}
[#list tag_bean.orderItems as item]
[/#list]
[/#if]
[/#if]
[/@cms_score_group]
如果新增了其他评分组设定了默认评分组，需要实现效果