更多详细资料在JEECMS官网：http://www.jeecms.com 　   主题论坛：http://bbs.jeecms.com

栏目模型相关说明：

　　首页模型：建立首页栏目时需要选择的模型，可以建立子栏目，适用于所有的系统类型，例如站点“首页”栏目；
　　文章模型：建立文章栏目时需要选择的模型，可以建立子栏目，只适用于文章系统，例如“军事“、”娱乐”等栏目；
　　单页模型：建立单页栏目时需要选择的模型，不能建立子栏目，适用于所有的系统，例如“关于我们”栏目；
　　跳转模型：建立跳转栏目时需要选择的模型，不能建立子栏目，适用于所有的系统，可跳转到任意网址，例如“论坛”栏目；

 

ID：	栏目模型对应的ID号
名 称：	栏目模型的完整名称
简 称：	栏目模型的简称
所属系统：	栏目模型所属的系统类型，例如文章系统、下载系统、图片系统等
栏目模板前缀：	栏目模型对应的栏目页模板文件前缀，默认文章模型对应的栏目页模板必须以“channel”作前缀，例如：channel_new.html
内容模板前缀：	栏目模型对应的内容页模板文件前缀，默认文章模型对应的内容页模板必须以“content”作前缀，例如：content_new.html
排列顺序：	栏目模型的排列顺序
可以有子节点：	栏目模型是否有子节点
显 示：	栏目模型的显示状态
操 作：	对栏目模型的修改、复制（用于创建新的栏目模型）、删除等操作

 

　栏目管理列表相关说明：

　　ID:栏目ID值，增加栏目时由系统按顺序依次生成。常用于标签调用中的参数。前面的复选框可以对一些栏目做批量处理；
　　名称：栏目的名称；
　　路径：栏目的访问路径，例如“南昌资讯”栏目设置的访问路径为nanchang，则其前台访问路径为：网站域名/nanchang/index.htm；
　　排列顺序：栏目在前台/后台栏目列表中的显示顺序值。单击“保存排列顺序”按钮，各栏目按顺序值依次排列，顺序值越小排列越靠前；
　　文档数量：属于该栏目的文章数量；
　　点击次数：该栏目的点击次数统计；
　　是否显示：设置该栏目是否在栏目列表中显示；
　 　操作：对该栏目进行修改或删除操作

这里我们采用开始时建立的空白的内容页模板（所有的内容页模板都必须以content做前缀，这里采用contetn_demo.html），然后将content_demo.html设为当前某个栏目的内容页模板，这样你可以在上面测试内容页各种标签的用法了。

一、标签原型说明

　　【文章导航】：[@cms.Position /]

　　【文章标题】：${arti.title}

　　【简短标题】：${arti.shortTitle}

　　【文章作者】：${arti.author}

　　【发布日期】：${arti.releaseDate}

　　【查看次数】：${arti.visitTotal}

　　【文章来源】：${arti.origin}

　　【文章摘要】：${arti.description}

　　【文章内容】：[@cms.ArtiContent /]

　　【内容分页】：[@cms.SysPage style='2'/]

二、明确标签的使用范围

　　我们在使用任何标签的之前，都必须明确其使用的范围，否则可能无法正常使用该标签。既然是内容页标签，其主要使用范围当然是内容页模板。即对应\WEB-INF\user_base\jeecms_com_www\template\article\default\文件夹下的content_××.html模板。

三、调试标签了解其使用方法

　　登录JEECMS后台，进入“模板管理->template->article->default”,点击修改开始时建立的content_demo.html模板（如果没有此模板则按照本文开头的说明创建），在模板内容处填写如下标签代码：

　　【文章导航】：[@cms.Position /]<br />

　　【文章标题】：${arti.title} <br />

　　【简短标题】：${arti.shortTitle}<br />

　　【文章作者】：${arti.author}<br />

　　【发布日期】：${arti.releaseDate}<br />

　　【查看次数】：${arti.visitTotal}<br />

　　【文章来源】：${arti.origin}<br />

　　【文章摘要】：${arti.description}<br />

　　【文章内容】：[@cms.ArtiContent /]<br />

　　【内容分页】：[@cms.SysPage style='2'/]<br />

 

jeecms投票系统：

在JEECMS中自带一个投票系统，用户可以自定义投票主题及投票方式。投票系统和留言板都属于JEECMS的辅助系统（auxiliary），在后台都有对应的模板可以控制显示样式。投票系统有投票列表显示模板和投票结果显示模板，分别对应后台管理中“模板管理->template->auxiliary->default->tag_VoteTopic.html”、“模板管理->template->auxiliary->default->sys_VoteResult.html”，用户可自行修改显示样式。

一、标签原型说明
　　【标签名】：[@cms.VoteTopic 属性='值' /]
　　【作　用】：显示投票主题
　　【参　数】：
　　　　id：投票ID。（默认为最新投票）
　　　　inner：是否使用标签中直接编写html代码。【0：否；1：是】（默认0）
　　　　cssClass：容器class
　　　　cssStyle：容器style
　　　　style：标签内部样式。如果指定sysContent或userContent，则该项无效。【1：普通列表；】（默认1）
　　　　sysTpl：使用系统模板。【0：不使用；1：使用】（默认1）
　　　　custom：字符串数组。用于个性化处理。（默认空数组）
　　【备　注】：在代码模式下编辑，各属性值必须使用单引号，属性排列顺序不分先后。

　【示　例】：
　　　　 [@cms.VoteTopic sysTpl='0'/]

 

JEECMS留言板：

为了方便网友和站长互动交流，JEECMS系统自带了留言板功能，同时也提供了一套默认的留言板样式。留言板的模板可以在管理后台“模板管理->template->auxiliary->default->sys_Gstbook.html”中修改。其中的留言列表使用了[@cms.MsgList /]标签，该标签的具体显示样式是在管理后台“模板管理->template->auxiliary->default->tag_MsgList.html”中定义的。

一、标签原型说明
　　【标签名】：[@cms.MsgList 属性='值' /]
　　【作　用】：显示留言列表
　　【参　数】：
　　　　ctgId：留言类别。类别ID。（默认全部）
　　　　recommend：是否推荐。【0：全部；1：推荐留言】（默认0）
　　　　orderBy：排序方式。【0：留言时间从新到旧；1：留言时间从旧到新；】（默认0）
　　　　firstResult：第一条记录。（默认0）
　　　　count：记录数。（默认20）
　　　　isPage：是否分页。【0：不分页；1：分页】（默认0）
　　　　pageNo：页号。（默认当前页）
　　　　cssClass：容器class
　　　　cssStyle：容器style
　　　　style：标签内部样式。如果指定sysContent或userContent，则该项无效。【1：普通列表；】（默认1）
　　　　inner：是否使用标签中直接编写html代码。【0：否；1：是】（默认0）
　　　　isLoop：内容是否循环。【0：不循环；1：循环】（默认1）
　　　　sysTpl：使用系统模板。【0：不使用；1：使用】（默认1）
　　　　sysContent：系统内容样式。（默认0）
　　　　userContent：自定义内容文件名。如果指定了系统内容样式，则该项无效。（默认空）
　　　　sysPage：系统分页样式。【0：不分页；1：样式一；2：样式二】（默认0）
　　　　userPage：自定义分页样式文件名。如果指定了系统分页样式，则该项无效。（默认空）
　　　　custom：字符串数组。用于个性化处理。（默认空数组）
　　【备　注】：在代码模式下编辑，各属性值必须使用单引号，属性排列顺序不分先后。

　【示　例】：
　　　　 [@cms.MsgList count='3' sysTpl='0' isPage='1'/]
 

JEECMS当前位置：

　在网站页面中我们经常要显示当前页面的位置，例如：当前位置：首页 > JEECMS教程 > 环境搭建 > 正文。在JEECMS标签中提供了一个显示页面的当前位置调用标签，只需将该标签放到页面的相应地方，设置好调用参数即可，简单方便。

一、标签原型说明

　　【标签名】：[@cms.Position 属性='值' /]

　　【作　用】：显示页面的当前位置

　　【参　数】：

　　homepage —-首页显示方式。【1：站点简称；自定义】（默认：首页）

　　title ---内容页显示方式。【0：不显示；1：显示内容标题；自定义】（默认：正文）

　　split ---分割符号。（默认：“>”)

　　target ---是否原窗口打开。【0：原窗口打开；1：新窗口打开】（默认：原窗口打开）

　　class ---链接外部样式，等同于html中的class属性

　　style ---自定义标签样式，等同于html中的style属性

　　【示　例】：

　　　　 [@cms.Position homepage='1' split='|' target='1' style='color:#f00'/]

【备　注】：在代码模式下编辑，各属性值必须使用单引号，属性排列顺序不分先后。

 

JEECMS文章列表：

在页面中获取栏目列表的时候我们要用到[@cms.ChnlList /]标签，本标签不仅可以单独使用，还可以配合其它标签使用，达到更加丰富的效果。本节教程都是在新建的演示空白首页模板中作演示。

一、标签原型说明

　　【标签名】：[@cms.ChnlList 属性='值' /]

　　【作　用】：显示各栏目列表

　　【参　数】：

　　　id：父栏目ID。（默认为空：自动获取当前栏目ID）

　　　orderBy：排序方式。【0：优先级升序；1：优先级降序；2：点击次数升序；3：点击次数降序】（默认0）

　　　isDisplay：是否只获取显示的栏目。【0：获取所有；1：只获取显示的栏目】（默认1）

　　　hasContent：是否只获取可以有内容的栏目。【0：获取所有；1：只获取可以有内容的栏目】（默认0）

　　　linkClass：链接class

　　　linkTarget：链接打开方式。【0：当前窗口；1：新窗口】（默认0）

　　　style：标签内部样式。如果指定sysContent或userContent，则该项无效。【1：普通链接列表；】（默认1）

　　　sysTpl：使用系统模板。【0：不使用；1：使用】（默认1）

　　　sysContent：系统内容样式。（默认0）

　　　userContent：自定义内容样式。如果指定了系统内容样式，则该项无效。（默认0）

　　　sysPage：系统分页样式。【0：不分页；1：样式一；2：样式二】（默认0）

　　　userPage：自定义分页样式。如果指定了系统分页样式，则该项无效。【0：不分页；1：样式一；2：样式二】（默认0）

　　　custom：字符串数组。用于个性化处理。（默认空数组）

　　【备　注】：在代码模式下编辑，各属性值必须使用单引号，属性排列顺序不分先后。

二、明确标签的使用范围

　　我们在使用任何标签的之前，都必须明确其使用的范围，否则可能无法正常使用该标签。 [@cms.ChnlList /]标签的使用范围是：首页模板，栏目页模板，即对应\WEB-INF\user_base\jeecms_com_www\template\article\default\文件夹下的index_××.html模板、channel_××.html模板

三、调试标签了解其使用方法

1、单独标签调用示例： [@cms.ChnlList/]

2、自定义标签调用示例：
　 　　[@cms.ChnlList id='' inner='1';c,i]
　　　　<a href="${c.url}">${c.name}</a>[#if (i+1)%2==0]<br/>[/#if]
　　　[/@cms.ChnlList]

3、配合其它标签嵌套调用示例：
[@cms.ChnlList id='' sysType='article' hasContent='1' inner='1';c]
<table width="300" border="0" cellpadding="0" cellspacing="1" bgcolor="#eee">
<tr>
<td height="30" bgcolor="#EEEEEE"><a target="_blank" href="${c.url}">${c.name}</a></td>
</tr>
<tr>
<td bgcolor="#FFFFFF">[@cms.ArtiList chnlId=c.id sysContent='1-1' titLen='20' count='6' /]</td>
</tr>
</table>
[/@cms.ChnlList]

 

JEECMS上一篇&下一篇：

【ArtiSide 标签】表示获取文章“上一篇／下一篇”的链接列表。仅用于文章内容页模板。

一、标签原型说明
　　【标签名】：[@cms. ArtiSide属性='值' /]
　　【作　用】：获取文档“上一篇／下一篇”的链接列表
　　【参　数】：
　　　　side：【pre：上一篇；next：下一篇】
　　　　notExist：文章不存在时的提示信息。（默认：没有了）
　　【示　例】：
　　　　上一篇：[@cms.ArtiSide side='pre'/] 下一篇：[@cms.ArtiSide side='next'/]
　　【备　注】：在代码模式下编辑，各属性值必须使用单引号，属性排列顺序不分先后。

二、明确标签的使用范围
　　我们在使用任何标签的之前，都必须明确其使用的范围，否则可能无法正常使用该标签。 【ArtiSide 标签】仅限于文章内容页模板中使用，即对应\WEB-INF\user_base\jeecms_com_www\template\article\default\文件夹下的content_××.html模板。

三、调试标签了解其使用方法
　　登录JEECMS后台，进入“模板管理->template->article->default”,这里还是使用前面教程中建立的content_demo.html模板，将里面都内容清空，然后在模板内容处填写如下标签代码：
　　【文章标题】：${arti.title} <br />
　　【文章内容】：[@cms.ArtiContent /]<br />
　　 [@cms.SysPage style='2'/]<br />
　　上一篇：[@cms.ArtiSide side='pre' notExist ='前面没有文章了！'/]<br />
　　下一篇：[@cms.ArtiSide side='next' notExist ='后面没有文章了！'/]<br />

　　点保存按钮保存该内容模板，到文章对应的栏目下设置内容页模板为content_demo.html模板，这里我们用的主要是“图片”栏目的文章，所以将“图片”栏目的内容页模板设置为“content_demo.html”，然后返回前台点击一篇文章，得到如下效果：

 

JEECMS效果列表：

　【ArtiList 标签】在JEECMS中使用的频率可以说是最高的，通过这个标签，你不仅可以得到一个文章列表，而且可以通过不同的参数组合得到不同的显示效果。比如文章图文列表、文字或图片跑马灯、文字或图片上下循环滚动等等。这里我们还是使用空白的首页模板（index_demo.html）来演示标签的用法。

一、标签原型说明
【标签名】：[@cms. ArtiList 属性='值' /]
【作　用】：获取文章列表数据
【参　数】：
 

 

属性名称	属性说明	默认值	可选值
chnlId	栏目ID，栏目页中可不设置，系统会自动获取当前栏目ID	当前栏目ID	空：显示全站文章列表； 栏目ID：指定栏目文章列表
attr	文章属性ID	空	1：普通   2：图文 3：焦点   4：头条    5：滚动
sysContent	列表显示方式	1-1	1-1：普通标题列表 1-2：图文列表 2-1：标题列表翻滚 2-2：图文列表翻滚 3-1：焦点图
orderBy	排序方式	0	0：发布时间降序； 1：发布时间升序； 2：固顶降序； 3：置顶降序； 4：日点击降序； 5：周点击降序； 6：月点击降序； 7：季点击降序； 8：年点击降序； 9：总点击降序
recommend	是否推荐	0	0：所有文章 1：推荐文章
titLen	标题长度	20	自定义
target	链接打开目标	0	0：原窗口打开 1：新窗口打开
headMark	文章标题图标	0	0：无图标 1：黑色小圆点 2：红色小圆点 3：蓝色单箭头 4：蓝色双箭头 自定义图标：填写图标路径
lineHeight	文章列表每行的行高	空	自定义
bottomLine	每行标题下是否带分隔线	0	0：无分隔线 1：有分隔线
ctgForm	文章类别形式	0	0：不显示文章类别 1：显示栏目类别 2：显示站点名称
ctgClass	文章类别的css-class	空	自定义css样式的class名称
dateFormat	文章发布日期显示格式	0	0：不显示日期 1：”年-月-日 时-分-秒” 格式 2：”年-月-日” 格式 3：”月-日 时-分” 格式 4：”月-日” 格式
datePosition	日期排列位置	1	1：紧跟标题之后 2：右对齐 3：左对齐
isPage	是否显示分页	0	0：否；1：是
count	每页列表显示数量	20	自定义
仅当sysContent='1-2'（图文列表）时，以下标签属性才有效
picWidth	按百分比显示图片宽度	25（即每个图片占总宽度的25%，每行可放四张图片）	自定义
picHeight	每行图片显示高度	110	自定义
仅当sysContent='3-×'（焦点图）时，以下标签属性才有效
flashWidth	焦点图宽度	296（px）	自定义
flashHeight	焦点图总高度	200（px）	自定义
textHeight	焦点图文本高度	20（px）	自定义
仅当sysContent='2-×'（特效显示）时，以下标签属性才有效
rollDisplayHeight	显示区高度	28	自定义
rollLineHeight	行高	28	自定义
rollCols	列数（一行中包含几列）	1	自定义
rollSpeed	滚动速度，值越小越快，最小为1	1	自定义
isSleep	是否停顿	1	0：不停顿； 1：停顿
rollSleepTime	停顿时间，值越大停顿越久	50	自定义
rollCount	一次滚动的行数	1	自定义
rollSpan	一次滚动的像素	1	自定义
其它高级标签属性（用于用户个性设置）
searchKey	在标题、tags和描述中搜索指定关键字的文章列表，用于搜索页模板	空	自定义关键字
style	标签内部样式，如果指定sysContent或userContent，则该项无效	1	1：普通列表
sysTpl	指定系统模板	1	自定义
sysContent	系统内容样式	0	自定义
userContent	用户内容样式，当sysContent=1时有效	空	自定义
sysPage	系统分页样式	0	自定义
userPage	用户分页样式，当sysPage=1时有效	空	自定义
upSolution	指定其它模板方案样式	空	自定义
upWebRes	指定其它站点样式	空	自定义
pageClass	分页栏css样式的class名称	空	自定义
pageStyle	分页栏css自定义style样式	空	自定义
custom	用户自定义属性集合	空	自定义

 

【示　例】：

　　[@cms.ArtiList chnlId='' count='5' sysContent='1-1' titLen='25' lineHeight='1' dateFormat='4' datePosition='2' headMark='2' target='1'/]

【备　注】：在代码模式下编辑，各属性值必须使用单引号，属性排列顺序不分先后。

 

二、明确标签使用范围

　　我们在使用任何标签的之前，都必须明确其使用的范围，否则可能无法正常使用该标签。

【ArtiList 标签】的使用范围是：首页模板，栏目页模板，内容页模板， 即对应\WEB-INF\user_base\jeecms_com_www\template\article\default\文件夹下的index_××.html模板、channel_××.html模板、content_××.html模板

三、调试标签了解其使用方法

　　登录JEECMS后台，进入“模板管理->template->article->default”,点击修改开始时建立的index_demo.html模板（如果没有此模板则按照本文开头的说明创建），在模板内容处填写如下标签代码（为了演示效果美观，本处代码中引入了系统默认css，可去除）：

（1）．文章列表

<link href="${sysResRoot}/front.css" type="text/css" rel="stylesheet" />

[@cms.ArtiList chnlId='' count='5' sysContent='1-1' titLen='25' lineHeight='1' dateFormat='4' datePosition='2' headMark='2' target='1'/]

　　点保存按钮，然后返回前台站点首页刷新，得到如下效果：

（2）．图文列表

<link href="${sysResRoot}/front.css" type="text/css" rel="stylesheet" />
[@cms.ArtiList chnlId='' attr='2' count='5' sysContent='1-2' titLen='25' target='1' picWidth='25' picHeight='110'/]

　　点保存按钮，然后返回前台站点首页刷新，得到如下效果：