jeecms学习笔记
内容管理系统
1.栏目列表标签
作用：获取栏目的列表
[@cms_channel_list]
[#list tag_list as b]
<a href="${b.url}" target="_parent">${b.name}</a></font>
[/#list]
[/@cms_channel_list]
参 数：
parentId：存在时，获取该栏目的子栏目，不存在时，获取顶级栏目channel.parent.id
siteId：站点ID。存在时，获取该站点顶级栏目，不存在时获取当前站点顶级栏目。（仅在parentId不存在时起作用）
hasContent：是否只获取可以有内容的栏目。【0：获取所有；1：只获取可以有内容的栏目】（默认0）
linkClass：链接class
style：标签内部样式。如果指定sysContent或userContent，则该项无效。【1：普通链接列表；】（默认1）
sysTpl：使用系统模板。【0：不使用；1：使用】（默认1）
sysContent：系统内容样式。（默认0）
userContent：自定义内容样式。如果指定了系统内容样式，则该项无效。（默认0）
sysPage：系统分页样式。【0：不分页；1：样式一；2：样式二】（默认0）
userPage：自定义分页样式。如果指定了系统分页样式，则该项无效。【0：不分页；1：样式一；2：样式二】（默认0）
custom：字符串数组。用于个性化处理。（默认空数组）
【备 注】：在代码模式下编辑，各属性值必须使用单引号，属性排列顺序不分先后。
2.栏目列表
作用：获取指定栏目
[@cms_channel id='1']
<ahref="${tag_bean.url}" target="_blank">${tag_bean.name}</a>
[/@cms_channel]
参数：
id：栏目ID
path：栏目路径
siteId: 站点ID，存在时获取该站点栏目，不存在时获取当前站点栏目
3.文章列表标签
作用：获取文章列表
[@cms_content_list count='10' titLen='15' orderBy='9' channelOption='1'append='...']
[#list tag_list as a]
<a href="${a.url}" title="${a.title}" target="_blank">[@text_cut s=a.title len=titLen append=append/]</a>[${a.date?string(dateFormat)}]
[/#list]
[/@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，用“，”分开。(a.type.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：文章列表显示样式
4.文章列表及分页
作用：获取文章列表并分页
[@cms_content_page count='20' channelId="${channel.id}" dateFormat='yyyy-MM-dd' orderBy='1' channelOption='1']
[#list tag_pagination.list as a]
<a href="${a.url}" target="_blank" title="${a.title}">${a.title}</a>
[/#list]
[#if tag_pagination.list?size gt 0]
[@cms_pagination sysPage='1'/]
[/#if]
[/@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，用“，”分开(a.type.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查询相关文章
5.文章内容相关信息
获取栏目下内容
作者：${content.author !}
发布日期：${content.releaseDate?string("YYYY-MM-dd") or
文章内容：${content.txt}
文章标题：${content.title}
获取单页中的内容
[@cms_channel id=channel.id]
${tag_bean.txt}
[/@cms_channel]
6.第一个子栏目
作用：获取栏目下的第一个子栏目
example：
[#list channel.nodeList as n]
<span>${n.name}</span>
[/#list]
[@cms_channel_list parentId='${channel.id}']
[#list tag_list as c]
<!-- 取当前栏目下第一个子栏目 -->
[#if c_index == 0]<span>${c.name}</span>[/#if]
[/#list]
[/@cms_channel_list]
7.网站访问次数
作用：获取网站访问次数
<script src="/${res}/js/indexshow.js" type="text/javascript"></script>
<script src="/${res}/js/imgFlip.js" type="text/javascript"></script>
<script src="${resSys}/jquery.js" type="text/javascript"></script>
<script src="${resSys}/jqueryUI/jquery-ui.js" type="text/javascript"></script>
<script src="${resSys}/front.js" type="text/javascript"></script>
<script type="text/javascript">
$(function() {
Cms.siteFlow("${base}", location.href, document.referrer);
$.cookie("_site_id_cookie","${site.id!}",{path: '${base}' });
});
访客数总量<span id="pv"></span> //刷新就会增加
<span id="visitor"></span> //根据ip确定，不同ip才会增加
8.留言板
作用：
修改special中的guestbook_index
<a href="${base}/guestbook.jspx">//使用链接
9.站内搜索
建立搜索框
<form action="${base}/search.jspx" target="_blank">
<TR>
<TD width="96" align=right>站内搜索：</TD>
<TD width="164" align=middle>
<DIV align=center>
<input required name="q" class="s_keyword" type="text" size="20">
</TD>
<TD width="48"><input type="submit" class="s_bt" value="检索"></TD>
</TR>
</form>
修改spacial中的search_result
[#if q??]
[@cms_lucene_page q=q channelId=channelId descLen='100' append='...' count='20'siteId='7']
[#list tag_list as s]
${s.id!} //搜索文章的id
<a href="${s.url}"> //搜索的文章的url
${s.title?replace('${q!}', "<span style='color: red;'>${q!}</span>")} //搜索的文章标题
</a>
[${s.releaseDate?string("YYYY-MM-dd")}] //发布日期
${s.ctgName} //文章所属的栏目
[/#list]
[@cms_pagination sysPage='1'/]</td>
[/@cms_lucene_page]
[/#if]
10.附件
[#if content.attachments?size gt 0]
[#list content.attachments?reverse as c ]
<p style="height: 25px;position: absolute;bottom: 0;left: 0">
<span class="red14">附件:<a class="zi-hong1" href="${c.path}"> ${c.name}</a></span>
</p>
[/#list]
[/#if]
11.专题
（在首页）获取专题列表
[@cms_topic_list count='2' descLen='36' append='...' orderBy="2"]
[#list tag_list as t]
<tr>
<td align="center">
<a href="${base}/topic/${t.id}.jspx" target="_blank">
<img src="${t.titleImg!site.defImg}" width="220" height="50" border="0"/>
</a>
</td>
</tr>
[/#list]
[/@cms_topic_list]
（在各专题页）获取专题内文章列表--[默认样式为topic-default]
[@cms_content_page count='20' append='...' topicId=topic.id orderBy='4' dateFormat='yyyy-MM-dd']
[#list tag_pagination.list as t]
<tr>
<td><IMG src="/${res}/images/news.gif">
<a href="${base}/topic/${t.id}.jspx" target="_blank" class="text-overflow">[@text_cut s=t.title len=descLen append=append/]</a>
<span style="color: rgb(93,93,93);">[${t.date?string(dateFormat)}]</span>
</td>
</tr>
[/#list]
[@cms_pagination sysPage='1'/]
[/@cms_content_page]
12.其他
判断某属性（简短标题）是否存在
[#if content.shortTitle??]
<span class="title_wj">${content.title}</span><br/>
<span style="display: block;font-size: 20px;margin-top: 10px;font-weight: 600; margin-bottom: 6px;">${content.shortTitle !}</span>
[#else]
<span class="title_wj">${content.title !}</span>
[/#if]
根据文章列表index增加图案
（五个标题后加一个图片）
[@cms_content_page count='20' channelId="${channel.id}" dateFormat='yyyy-MM-dd' orderBy='2']
[#list tag_pagination.list as a]
<IMG src="/${res}/images/news.gif"> <a href="${a.url}" target="_blank">${a.title}[${a.releaseDate?string("yyy-MM-dd") !}]</a>
[#if (a_index+1)%5 == 0]
<img background=/${res}/images/bg_line10.gif height=1></TD>
[/#if]
[/#list]
[#if tag_pagination.list?size gt 0]