jeecms 标签详细使用说明教程文件
J e e c m s2012标签详细使用说明
JEECMS V2012标签说明文档
目录
[@cms_tag_list] Tag列表标签 (3)
[@cms_lucene_list] 搜索结果列表标签 (4)
[@cms_lucene_page] 搜索结果分页标签 (6)
[@cms_Include] 页面模板包含标签 (8)
[@cms_guestbook_list] 留言列表标签 (9)
[@cms_content_page] 文章列表分页标签 (10)
[@cms_content_list] (12)
[@cms_Content] 文章对象标签 (16)
[@cms_topic_page] 专题分页标签 (17)
[@cms_topic_list] 专题列表标签 (19)
[@cms_vote] 投票标签 (20)
[@cms_comment_page] 评论分页标签 (22)
[@cms_comment_list] 评论列表标签 (24)
[@cms_channel] 栏目对象标签 (26)
[@cms_channel_list] 栏目列表标签 (28)
[@cms_pagination/]参数：sysPage 分页 (29)
[@process_time/]页面处理时间标签 (31)
[@cms_tag_list] Tag列表标签
Tag列表标签
作用：显示tag列表
示例：
热门tags：
[@cms_tag_list count='8']
[#list tag_list as tag] target="_blank">${https://www.360docs.net/doc/292435885.html,}
效果截图：
[@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_lucene_page] 搜索结果分页标签搜索结果分页标签
作用：对搜索结果分页
参数：
q: 搜索关键字
siteId:站点ID
channeled:栏目ID
startDate:：开始时间
endDate:结束时间
示例：
[#if q??]
[@cms_lucene_page 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_page]
[/#if]
结果截图：
注意：[@cms_lucene_list]与[@cms_lucene_page]的效果显示是不一样的，[@cms_lucene_list]其显示的结果由其内的熟悉count和搜索结果的总数决定的，如果搜索结果的总数大于count
则显示的结果就为count设定的值，如果搜索结果的总数小于count设定的值则显示搜索结果的总数。而[@cms_lucene_page]不一样，它始终是会显示出所有的搜索结果来的，只是每一页显示的值是由count决定的，所以，我建议，一般情况下，还是用[@cms_lucene_page]比较好，因为用它既能显示出搜索结果的分页又能正确的显示出搜索出来的结果总数。
[@cms_Include] 页面模板包含标签
页面模板包含标签：
作用：把做好的页面引入到另外一个页面上去，一般是整个网站的一些公共部分，每个网页都需要的，比如页头，页脚。
[#include "../include/页头顶栏.html"/]
示例：
[#include "../include/页头顶栏.html"/]
[#include "../include/页头导航栏.html"/]
[#include "../include/页头搜索栏.html"/]
效果截图：
[@cms_guestbook_list] 留言列表标签
留言列表标签
作用：显示用户的留言列表
参数:
siteId:站点ID
ctgId:类别ID，用于调用不同类别
checked:是否审核后显示。0，不审核 1，审核默认是不审核
示例：
[@cms_guestbook_list count='10']
[#list tag_list as m]
- [${https://www.360docs.net/doc/292435885.html,!}]${m.titleHtml!}
- ${m.contentHtml!}
[/#list]
[/@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，用“，”分开。
typeId：类型ID，可选，允许多个类型ID，用“，”分开。
Recommend：是否推荐。 0 ：所有都推荐 1 ：推荐 2 ：不推荐，默认所有
title：标题，可以为null
image：标题图片， 0 ：所有 1 ：有 2 ：没有。默认所有
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：总顶降序
excludeId：不包含的文章ID，用于按tag查询相关文章
示例：
专题资讯库 | |
[@cms_content_page topicId=topic.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]文章列表标签
文章列表标签
作用：显示文章列表
参数：
id：文章ID，允许多个文章的ID，用“，”分开。排斥其他所有删选参数
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，用“，”分开。
typeId：类型ID，可选，允许多个类型ID，用“，”分开。
Recommend：是否推荐。 0 ：所有都推荐 1 ：推荐 2 ：不推荐，默认所有
title：标题，可以为null
image：标题图片， 0 ：所有 1 ：有 2 ：没有。默认所有
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：总顶降序
excludeId：不包含的文章ID，用于按tag查询相关文章
style_list：文章列表显示样式
文字列表
lineHeight：行高；【行高】
headMarkImg: 列表头图片；【图片地址】
headMark: 列表头编号；【1：小黑点；2：小红点；3：单箭头；4：双箭头】bottomLine: 下划线；【0：无；1：有】不能为空。
dateFormat: 日期格式；【java日期格式，如：yyyy-MM-dd】
datePosition: 日期位置；【1：后面左边；2：后面右边；3：前面】不能为空
ctgForm: 类别；【0：无；1：栏目；2：站点】不能为空
showTitleStyle：显示标题样式；【0：不显示；1：显示】不能为空
useShortTitle: 是否使用简短标题；【0：不使用；1：使用】不能为空
titLen: 标题长度；【英文字母按半个计算】为空则不截断
target: 是否新窗口打开；【0：原窗口；1：新窗口】不能为空
styleList：文章列表显示样式
示例：
- [@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]
效果截图：
图文列表
picWidth: 图片宽度；【按百分比计算（如为24.9；即每个图片占总宽度的24.9%，每行可放四张图片）】不能为空。
picHeight: 每行图片显示高度；【按像素px计算】不能为空。
picFloat: 图片是否左浮动；【0：否；1：是】不能为空。
rightPadding: 图片右边距；【按像素px计算】不能为空。
showTitleStyle：显示标题样式；【0：不显示；1：显示】不能为空
useShortTitle: 是否使用简短标题；【0：不使用；1：使用】不能为空
titLen: 标题长度；【英文字母按半个计算】为空则不截断
target: 是否新窗口打开；【0：原窗口；1：新窗口】不能为空
示例：
src="${a.typeImg!site.defImg}" alt="${a.title}" />
append=append/]
精彩图文
[@cms_content_list typeId='2' count='20' titLen='10' channelOption='1']
[#list tag_list as a]
[/#list]
[/@cms_content_list]
效果截图：
焦点图
focusType: 焦点图类型；【1；2；3】不能为空
flashWidth: flash宽度；【按像素px计算】不能为空。
flashHeight: flash高度；【按像素px计算】不能为空。
textHeight: 文本高度；【按像素px计算】不能为空。
useShortTitle: 是否使用简短标题；【0：不使用；1：使用】不能为空
titLen: 标题长度；【英文字母按半个计算】为空则不截断
示例：
[@cms_content_list typeId='3' styleList='3-1' titLen='20' count='5' flashWidth='280' flashHeight='200' textHeight='20' channelOption='1' tpl='2'/]
效果截图：
[@cms_Content] 文章对象标签
文章对象标签
作用：显示某篇文章
参数：
id: 文章ID
next:下一篇
channeled:l栏目ID
示例：
onclick="Cms.up('${base}',${content.id},${content.ups});">
顶
onclick="Cms.down('${base}',${content.id},${content.downs});"> id="downs"> 踩
- 上一篇：[@cms_content id=content.id next='1' channelId=channel.id][#if tag_bean??]
href="${tag_bean.url}">${tag_bean.title}[#else]没有了
[/#if][/@cms_content]
- 下一篇：[@cms_content id=content.id next='0' channelId=channel.id][#if tag_bean??]
href="${tag_bean.url}">${tag_bean.title}[#else]没有了
[/#if][/@cms_content]
效果截图：
[@cms_topic_page] 专题分页标签
专题分页标签
作用：对页面显示的专题列表进行分页
参数：
channelId:栏目ID
recommend：是否推荐
示例：
结果截图：
[@cms_topic_list] 专题列表标签
专题列表标签
作用：显示专题列表
参数：
channeled:栏目ID
recommend：是否推荐
示例：
src="/${res}/img/topic/lm_2.gif"/> | 热门专题 |
[@cms_topic_list count='4' descLen='36' append='...'] [#list tag_list as t]
[/#list] [/@cms_topic_list] | |
结果截图：
[@cms_vote] 投票标签
投票标签
作用：实现投票模块
参数：
id:投票ID 可以为空，为空则获取站点的默认投票
siteId:站点ID 默认为当前站点
示例：
[@cms_vote]
[#if !tag_bean??]
[#else]