Jeecms_2012标签详细使用说明.doc

JEECMS V2012标签说明文档目录cms_tag_list Tag列表标签2cms_lucene_list 搜索结果列表标签3cms_lucene_page 搜索结果分页标签3cms_Include 页面模板包含标签3cms_guestbook_list 留言列表标签3cms_content_page 文章列表分页标签3cms_content_list3cms_Content 文章对象标签3cms_topic_page 专题分页标签3cms_topic_list 专题列表标签3cms_vote 投票标签3cms_comment_page 评论分页标签3cms_comment_list 评论列表标签3cms_channel 栏目对象标签3cms_channel_list 栏目列表标签3cms_pagination/参数：sysPage 分页3process_time/页面处理时间标签3cms_tag_list Tag列表标签Tag列表标签作用：显示tag列表示例：热门tags：cms_tag_list count=8#list tag_list as tag$#if tag_has_next|/#if/#list/cms_tag_list效果截图：cms_lucene_list 搜索结果列表标签搜索结果列表标签作用：显示搜索出来的结果列表参数：q: 搜索关键字siteId:站点IDchanneled:栏目IDstartDate:：开始时间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.titletext_cut s=s.description len=descLen append=append/来源： $s.origin!本站原创    浏览次数：$s.views次    发布时间： $s.releaseDate /#list /cms_lucene_list /#if结果截图：cms_lucene_page 搜索结果分页标签搜索结果分页标签作用：对搜索结果分页参数：q: 搜索关键字siteId:站点IDchanneled:栏目IDstartDate:：开始时间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.titletext_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:站点IDctgId:类别ID，用于调用不同类别checked:是否审核后显示。0，不审核 1，审核 默认是不审核示例：网友留言 cms_guestbook_list count=10 #list tag_list as m$!$m.titleHtml!$m.contentHtml! /#list /cms_guestbook_list 结果截图：cms_content_page 文章列表分页标签文章列表分页标签作用：对显示的文章列表进行分页参数：tagId:TAG ID 允许多个TAG ID，用“，”分开。和tagNames之间二选一，ID优先级更高。tagName: TAG NAME 允许多个TAG NAME ，用“，”分开。topicId：专题IDchannelId:栏目ID，允许多个栏目ID，用“，”分开。和channelpath之间二选一，ID优先级更高。channelPath:栏目路径，允许多个栏目路径，用“，”分开。channelOption:栏目选项，用于单栏目情况下。 0 ：自身栏目 1 ：包含子栏目 2: 包含副栏目siteId：站点ID，可选，允许多个站点ID，用“，”分开。typeId：类型ID，可选，允许多个类型ID，用“，”分开。Recommend：是否推荐。 0 ：所有都推荐 1 ：推荐 2 ：不推荐，默认所有title：标题，可以为nullimage： 标题图片， 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 text_cut s=a.title len=titLen append=append/ $a.date?string(dateFormat)/#list /cms_content_page效果截图：cms_content_list 文章列表标签文章列表标签作用：显示文章列表参数：id：文章ID，允许多个文章的ID，用“，”分开。排斥其他所有删选参数tagId:TAG ID 允许多个TAG ID，用“，”分开。和tagNames之间二选一，ID优先级更高。tagName: TAG NAME 允许多个TAG NAME ，用“，”分开。topicId：专题IDchannelId:栏目ID，允许多个栏目ID，用“，”分开。和channelpath之间二选一，ID优先级更高。channelPath:栏目路径，允许多个栏目路径，用“，”分开。channelOption:栏目选项，用于单栏目情况下。 0 ：自身栏目 1 ：包含子栏目 2: 包含副栏目siteId：站点ID，可选，允许多个站点ID，用“，”分开。typeId：类型ID，可选，允许多个类型ID，用“，”分开。Recommend：是否推荐。 0 ：所有都推荐 1 ：推荐 2 ：不推荐，默认所有title：标题，可以为nullimage： 标题图片， 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：文章列表显示样式示例：热门资讯排行榜 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效果截图：图文列表picWidth: 图片宽度；【按百分比计算（如为24.9；即每个图片占总宽度的24.9%，每行可放四张图片）】不能为空。picHeight: 每行图片显示高度；【按像素px计算】不能为空。picFloat: 图片是否左浮动；【0：否；1：是】不能为空。rightPadding: 图片右边距；【按像素px计算】不能为空。showTitleStyle：显示标题样式；【0：不显示；1：显示】不能为空useShortTitle: 是否使用简短标题；【0：不使用；1：使用】不能为空titLen: 标题长度；【英文字母按半个计算】为空则不截断target: 是否新窗口打开；【0：原窗口；1：新窗口】不能为空示例： 精彩图文cms_content_list typeId=2 count=20 titLen=10 channelOption=1#list tag_list as a text_cut s=a.stit len=titLen append=append/#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: 文章IDnext:下一篇channeled:l栏目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_topic_page 专题分页标签专题分页标签作用：对页面显示的专题列表进行分页参数：channelId:栏目IDrecommend：是否推荐示例： cms_topic_page count=2 descLen=50 append=. #list tag_pagination.list as t$text_cut s=t.description len=descLen append=append/#list cms_pagination sysPage=1/ /cms_topic_page结果截图：cms_topic_list 专题列表标签专题列表标签作用：显示专题列表参数：channeled:栏目IDrecommend：是否推荐示例： 热门专题 cms_topic_list count=4 descLen=36 append=. #list tag_list as t$text_cut s=t.description len=descLen append=append/ /#list /cms_topic_list 结果截图：cms_vote 投票标签投票标签作用：实现投票模块参数：id:投票ID 可以为空，为空则获取站点的默认投票siteId:站点ID 默认为当前站点示例：网友投票cms_vote#if !tag_bean?没有默认投票主题#else $tag_bean.title?html #if tag_bean.multiSelect gt 1 #list tag_bean.items as item $item.title?html /#list #else #list tag_bean.items as item $item.title?html /#list /#if   查看投票结果 /#if/cms_votecms_comment_page 评论分页标签评论分页标签作用：对评论列表进行分页参数：siteId:站点idcontentId：内容IDgreaterThen: 评论内容最大支持大于多少checked: 是否需要审核recommend:是否推荐orderBy:排列顺序：0 ：按评论时间降序 1 ：按评论时间升序。 默认降序示例： cms_comment_page contentId=contentId count=6 orderBy=1 #if tag_pagination.list?size = 0 暂无相关评论！ #else #list tag_pagination.list as c $(mentUser.username)!匿名网友 于 $c.createTime 评论道: $c.textHtml! /#listcms_pagination sysPage=1/ /#if /cms_comment_page 效果图：注：cms_comment_page标签要和cms_pagination sysPage=1/标签一起使用，这样才会有效果。cms_comment_list 评论列表标签评论列表标签作用：显示评论列表参数：siteId:站点idcontentId：内容IDgreaterThen: 评论内容最大支持大于多少checked: 是否需要审核recommend:是否推荐orderBy:排列顺序：0 ：按评论时间降序 1 ：按评论时间升序。 默认降序示例：热门评论cms_comment_list siteId=1 count=5 recommend=1 textLen=50 append=.#list tag_list as c$(mentUser.username)!匿名网友 对 $c.content.title 评论道:text_cut s=c.textHtml len=textLen append=append/#list/cms_comment_list结果截图：cms_channel 栏目对象标签栏目对象标签作用：显示某个栏目参数：id：栏目IDpath：栏目路径siteId: 站点ID，存在时获取该站点栏目，不存在时获取当前站点栏目示例：cms_channel id=1$tag_/cms_channel效果截图：使用前：使用后：上面图片的整个效果的代码：cms_channel id=1$tag_/cms_channelcms_content_list channelId=1 count=6 orderBy=4 titLen=18descLen=40 append=. channelOption=1 #list tag_list as a #ifa_index = 0$a.stittext_cut s=a.desc len=descLen append=append/#else$a.ctgNametext_cuts=a.title len=titLen append=append/#if /#list /cms_content_listcms_channel_list 栏目列表标签栏目列表标签作用：显示各栏目列表参数：parentId：存在时，获取该栏目的子栏目，不存在时，获取顶级栏目channel.parent.idsiteId：站点ID。存在时，获取该站点顶级栏目，不存在时获取当前站点顶级栏目。（仅在parentId不存在时起作用）hasContent：是否只获取可以有内容的栏目。【0：获取