jeecms模板标签说明

Blex 2011-09-20

展开全文

第 1 章 Include标签

第1.1节功能简介

第1.2节标记说明

第 2 章 ArtiList标签

第2.1节功能简介

第2.2节标记说明

第 3 章 Position标签

第3.1节功能简介

第3.2节标记说明

第 4 章 ChnlList标签

第4.1节功能简介

第4.2节标记说明

第 5 章内容页常用标签

第5.1节标记说明

第 1 章模板规划

第1.1节资源文件

资源文件就是网页中用到的图片、CSS、JS等元素，在CMS系统中所有的资源文件在网站的根目录中的

/res_base/所属网站定义资源目录/TEMPLEATE/WEB

/res_base/所属网站定义资源目录/TEMPLEATE/WAP

解释：网站定义资源

在CMS系统中可以同时管理多个网站，也就是多个网站可以同时使用一套CMS系统，但是每一个网站都已属于自己独立的资源文件及模板文件目录。

第1.2节模板文件

定义了页面显示的主体框架，它的位置位于网站根目录下的/WEB_INF/user_base/所属网站模板目录；

模板规则：

以index前缀命名的为首页模板

以channel前缀命名的为栏目模板

以content前缀命名的为内容模板

以alone前缀命名的为栏目单页模板

第1.3节使用方式

1. 使用dw建立站点

2. 将网页中用到的资源文件分类分别放置到网站相关资源目录中

3. 将模板文件放置按照命名规则分别放置到网站相关模板目录中。

4. 将头部、底部等等具有通用元素的模板文件放置到模板目录中的include目录中

5. 将模板文件中所有资源引用改为绝对路径链接至资源目录中

6. 在栏目管理中将模板文件与栏目进行关联设置

7. 在模板文件中需要提取数据的位置放置相应的标签

第 2 章 Include标签

第2.1节功能简介

过网站设计经验的朋友可能都知道，我们可以将页面中经常要引用的公共部分（比如页头和页脚）独立开来，单独存放在一个页面中。这样做的好处就是可以在各个需要用到该部分的页面中用一个简单的包含语句就能把它引入进来，大大简化了工作量。

第2.2节标记说明

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

【作　用】：包含公用页面（如页头，页脚）

【参　数】：

name：包含模板的文件名

solution：模板方案名

【示　例】：

包含页头：[@cms.Include name='head.html' solution='default'/]

【备　注】：调用此标签前必须先建立相应的包含模板

第 3 章 ArtiList标签

第3.1节功能简介

【ArtiList 标签】在CMS中使用的频率可以说是最高的，通过这个标签，你不仅可以得到一个文章列表，而且可以通过不同的参数组合得到不同的显示效果。比如文章图文列表、文字或图片跑马灯、文字或图片上下循环滚动等等。

使用方式：

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

第3.2节标记说明

【标签名】：[@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：发布时间降序；

1：发布时间升序；

2：固顶降序；

3：置顶降序；

4：日点击降序；

5：周点击降序；

6：月点击降序；

7：季点击降序；

8：年点击降序；

9：总点击降序

recommend

是否推荐

0：所有文章

1：推荐文章

titLen

标题长度

自定义

target

链接打开目标

0：原窗口打开

1：新窗口打开

headMark

文章标题图标

0：无图标

1：黑色小圆点

2：红色小圆点

3：蓝色单箭头

4：蓝色双箭头

自定义图标：填写图标路

lineHeight

文章列表每行的行高

空

自定义

bottomLine

每行标题下是否带下划分隔线

0：无分隔线

1：默认分隔线

自定义样式：css中定义的样式名称

ctgForm

文章类别形式

0：不显示文章类别

1：显示栏目类别

2：显示站点名称

ctgClass

文章类别的css-class

空

自定义css样式的class名

dateFormat

文章发布日期显示格式

0：不显示日期

1：”年-月-日时-分-秒” 格式

2：”年-月-日” 格式

3：”月-日时-分” 格式

4：”月-日” 格式

datePosition

日期排列位置

1：紧跟标题之后

2：右对齐

3：左对齐

isPage

是否显示分页

0：否；1：是

count

每页列表显示数量

自定义

cssStyle

连接的样式

空

自定义

仅当sysContent='1-2'（图文列表）时，以下标签属性才有效

picWidth

按百分比显示图片宽度

25（即每个图片占总宽度的25%，每行可放四张图片）

自定义

picHeight

每行图片显示高度

110

自定义

仅当sysContent='3-×'（焦点图）时，以下标签属性才有效

flashWidth

焦点图宽度

296（px）

自定义

flashHeight

焦点图总高度

200（px）

自定义

textHeight

焦点图文本高度

20（px）

自定义

仅当sysContent='2-×'（特效显示）时，以下标签属性才有效

rollDisplayHeight

显示区高度

自定义

rollLineHeight

行高

自定义

rollCols

列数（一行中包含几列）

自定义

rollSpeed

滚动速度，值越小越快，最小为1

自定义

isSleep

是否停顿

0：不停顿；

1：停顿

rollSleepTime

停顿时间，值越大停顿越久

自定义

rollCount

一次滚动的行数

自定义

rollSpan

一次滚动的像素

自定义

其它高级标签属性（用于用户个性设置）

searchKey

在标题、tags和描述中搜索指定关键字的文章列表，用于搜索页模板

空

自定义关键字

style

标签内部样式，如果指定sysContent或userContent，则该项无效

1：普通列表

sysTpl

指定系统模板

自定义

sysContent

系统内容样式

自定义

userContent

用户内容样式，当sysContent=1时有效

空

自定义

sysPage

系统分页样式

自定义

userPage

用户分页样式，当sysPage=1时有效

空

自定义

upSolution

指定其它模板方案样式

空

自定义

upWebRes

指定其它站点样式

空

自定义

pageClass

分页栏css样式的class名称

空

自定义

pageStyle

分页栏css自定义style样式

空

自定义

第 1 章 Position标签

第1.1节功能简介

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

第1.2节标记说明

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

　　　最终效果：

首页 | 无线城市 | 城市要闻

第 2 章 ChnlList标签

第2.1节功能简介

在页面中获取栏目列表的时候我们要用到[@cms.ChnlList /]标签，本标签不仅可以单独使用，还可以配合其它标签使用，达到更加丰富的效果。

第2.2节标记说明

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

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

　　【参　数】：

属性名称

属性说明

默认值

可选值

父栏目ID

默认为空：自动获取当前栏目ID

空：当前栏目ID；

栏目ID：指定父栏目id

orderBy

排序方式

0：优先级升序；

1：优先级降序；

2：点击次数升序；3：点击次数降序

isDisplay

是否只获取显示的栏目

0：获取所有；

1：只获取显示的栏目

hasContent

是否只获取可以有内容的栏目

0：获取所有；

1：只获取可以有内容的栏目

linkClass

链接class样式

空

linkTarget

链接打开方式

0：当前窗口；

1：新窗口

sysPage

系统分页样式

0：不分页；

1：样式一；

2：样式二

userPage

自定义分页样式。如果指定了系统分页样式，则该项无效

0：不分页；

1：样式一；

2：样式二

单独标签调用示例：

[@cms.ChnlList id='' inner='1';c,i]

　　　<a href="${c.url}">${c.name}</a>[#if (i+1)%2==0]<br/>[/#if]

[/@cms.ChnlList]

配合其它标签嵌套调用示例

[@cms.ChnlList id='' sysType='article' hasContent='1' inner='1';c]

<table width="300" border="0" cellpadding="0" cellspacing="1"

bgcolor="#eee">

<tr>

</td>

</tr>

<tr>

[@cms.ArtiList chnlId=c.id sysContent='1-1' titLen='20' count='6' /]

</td>

</tr>

</table>

[/@cms.ChnlList]

第 1 章内容页常用标签

第1.1节标记说明

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

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

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

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

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

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

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

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

【文章内容】：${arti.content}

在Eclipse下创建Jeecms项目图文指南

Jeecms作为一个开源项目自发布以来受到全国各地JEE用户及爱好者的广泛关注，我们的Jeecms交流群也是人气飙升。目前群一已经满员，群二也接近百人。网友们非常支持Jeecms项目，特别是java界的业内人士以及在校大学生们经常给我们指出当前系统中存在的不足。在大家的一起努力下，Jeecms得到不断地完善，目前已经推出了Jeecms v2.0版。

其中，网友们也提出了一些使用上的问题，在此选一个问题给大家做个说明。

有些网友不知道如何将Jeecms导入到自己的项目中，或者在导入过程中出现一些问题，本文以Jeecms v2.0版程序做例子，用图文形式向大家解释导入过程。

一、准备工作：

1.搭建Jeecms的运行环境，具体过程在此不做赘述，可以参考Jeecms官网上的教程。

2.准备好Jeecms的程序包及源代码包，如图一所示。其中jeecms-v2.0-beta.rar为Jeecms的运行程序包，jeecms-2.0.0-beta-src.zip为源码包。

图一

3.将jeecms-v2.0-beta.rar解压后得到图二所示的文件列表，把其中的JeeCms文件夹拷贝到tomcat的webapps文件夹下，启动tomcat运行Jeecms安装向导。向导完成后，请务必重启tomcat。然后登录系统后台测试系统是否运行正常。

图二

注：由于Jeecms系统在安装前后的配置文件会产生变化，安装前的一些配置文件（比如web.xml）主要是用于运行安装向导的，而安装后的配置文件才是真正用于系统正常运行的，所以创建Jeecms项目前请先运行安装向导，我们需要导入到eclipse项目中的也是安装之后的程序。

二、导入Jeecms项目：

1.在Eclipse下建立一个新的项目，本实例中建立了一个名为jeecms_src的新项目，如图三所示。

图三