JEECMS站群管理系统-- 标签使用和模板的制作

1模板规划

1.1资源文件

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

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

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

解释：网站定义资源

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

1.2模板文件

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

模板规则：

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

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

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

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

1.3使用方式

1、使用dw建立站点

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

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

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

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

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

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

1.4标签调用样式

调用"JEECMS标签"的三种代码样式如下：
　　A、${标签名称}
　　B、[@cms.标签名称属性='值'/]
　　C、[@cms.标签名称属性='值'; 标签别名] 自定义样式模板 [/@cms.标签名称]
　　例如：
a、${web.name}标签用于调用网站名称
b、[@cms.ArtiList
chnlId='' count='10' sysContent='1-1' /]标签用于调用 10篇文章的列表

C、[@cms.ChnlList id='' inner='1';c]|<a href=="${c.url}">>${c.name}</a>
[/@cms.ChnlList]标签用于调用栏目列表，可用于网站导航条。
　　注意：abc实例是与上面ABC三种形式相对应的。大家可以逐个测试，举一反三

2 Include标签

2.1功能简介

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

2.2标记说明

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

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

【参　数】：

name：包含模板的文件名

solution：模板方案名

【示　例】：

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

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

2.3 明确标签的使用范围

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

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

2.4调试标签了解其使用方法

　　在使用【Include 标签】之前我们必须保证有可供此标签调用的包含模板，本实例只是起演示作用，为方便起见，这里就不再另外创建被包含的模板了，标签调用的是系统默认模板方案中的的head.html模板。

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0
Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html;
charset=gb2312" />
<title>Include标签测试</title>
<link href="${sysResRoot}/front.css" type="text/css"
rel="stylesheet" />
<link href="${root}/default/article/css/whole.css"
type="text/css" rel="stylesheet" />
<link href="${root}/default/article/css/layout.css"
type="text/css" rel="stylesheet" />
</head>

<body>
[@cms.Include name='head.html' solution='default'/]
</body>
</html>

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

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	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：默认分隔线自定义样式：css中定义的样式名称
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	自定义
cssStyle	连接的样式	空	自定义
仅当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样式	空	自定义

3.3 明确标签使用范围

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

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

3.4 调试标签了解其使用方法

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

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

（2）．图文列表

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

4 Position标签

4.1功能简介

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

4.2标记说明

【标签名】：[@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'/]
　最终效果：

5 ChnlList标签

5.1功能简介

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

5.2标记说明

【标签名】：[@cms.ChnlList 属性='值'
/]
【作　用】：显示各栏目列表
【参　数】：

属性名称	属性说明	默认值	可选值
id	父栏目ID	默认为空：自动获取当前栏目ID	空：当前栏目ID；栏目ID：指定父栏目id
orderBy	排序方式	0	0：优先级升序； 1：优先级降序； 2：点击次数升序；3：点击次数降序
isDisplay	是否只获取显示的栏目	1	0：获取所有； 1：只获取显示的栏目
hasContent	是否只获取可以有内容的栏目	0	0：获取所有； 1：只获取可以有内容的栏目
linkClass	链接class样式	空
linkTarget	链接打开方式	0	0：当前窗口； 1：新窗口
sysPage	系统分页样式	0	0：不分页； 1：样式一； 2：样式二
userPage	自定义分页样式。如果指定了系统分页样式，则该项无效	0	0：不分页； 1：样式一； 2：样式二

5.3明确标签的使用范围

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

5.4调试标签了解其使用方法

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]

6内容页常用标签

6.1标记说明

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

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

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

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

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

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

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

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

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