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]
   

   ${link.name}
       

        [/#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' ]
   

您搜索的“${input!}”， 共有${tag_pagination.totalCount!}个结果

   

      [#list tag_list as s]
     

       

${s.title?replace('${q!}', "${q!}")}

        [#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参数变更为查询多少条数据
具体例子：

 

热门资讯排行榜

 

 
 

    [@cms_content_list count='10' titLen='15' orderBy='9' channelOption='1']
    [#list tag_list as a]
   
• [@text_cut s=a.title len=titLen append=append/]

    [/#list]
    [/@cms_content_list]
 

 

 

单篇内容 [@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]

${tag_bean.title?html}

     

${tag_bean.description?html}

     

        [#list tag_bean.subtopics as subTopic]
       

         

${subTopic_index+1}、${subTopic.title?html}

         

          [#if subTopic.isRadio]
          [#list subTopic.voteItems as item]
          ${item_index+1}.${item.title?html}
          [/#list]
          [/#if]
          [#if subTopic.isMulti]
          [#list subTopic.voteItems as item]
          ${item_index+1}.${item.title?html}
          [/#list]
          [/#if]
          [#if subTopic.isText]
         
          [/#if]
         

       

       
        [/#list]
     

     

查看投票结果

[/#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，读取本内容下的评论
作用：对评论分页读取
具体例子： 

   [@cms_comment_page contentId=content.id count='6' orderBy='1']   
         

            [#if tag_pagination.list?size = 0]
           

暂无相关评论！

      [#else]
      [#list tag_pagination.list as c]
     

${(c.commentUser.username)!"匿名网友"}于 ${c.createTime} 评论道:

     

${c.textHtml!}

     

   [/#list]

[@cms_pagination sysPage='1'/]

            [/#if]
         

   
          [/@cms_comment_page]   
   

评论对象属性
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='...']
 

  [#list tag_list as c]
   

${(c.commentUser.username)!"匿名网友"}对${c.content.title}评论道:

   

[@text_cut s=c.textHtml len=textLen append=append/]

   

  [/#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']
${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]
 src="${(tag_bean.attr.flash_url)!}"[#if tag_bean.attr.flash_width?? && tag_bean.attr.flash_width!=""] width="${tag_bean.attr.flash_width}"[/#if][#if tag_bean.attr.flash_height?? && tag_bean.attr.flash_height!=""] height="${tag_bean.attr.flash_height}"[/#if]>
[/#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]
 
 

      [#list tag_bean.orderItems as item]
     
• 
           

  0票

  
           [#if item.imagePath??]

  

  [/#if]
           

  ${item.name!}

  
       

      [/#list]
   

  
   
  [/#if]
  [/#if]
 [/@cms_score_group]
如果新增了其他评分组设定了默认评分组，需要实现效果