网站内容管理系统建设手册.docx

网站内容管理系统建设手册.docx

《网站内容管理系统建设手册.docx》由会员分享，可在线阅读，更多相关《网站内容管理系统建设手册.docx（13页珍藏版）》请在冰豆网上搜索。

网站内容管理系统建设手册

Lerx网站内容管理系统

模板建设手册

Lerx网络科技

2012-11-12

一、概述

利用Lerx网站内容管理系统（以下简称：

Lerx）建立的网站展现的内容其实都是模板的内容。

Lerx本身并不主动输出HTML代码，这是Lerx的基本原则之一，即网页右键查看到的网站源代码全是模板代码即是用户自已的代码，包括Javascript代码。

因此，模板对于Lerx来说至关重要，设计一份精致的模板会直接影响到网站的美观与性能。

Lerx可以很方便的将模板导入导出，导出时Lerx模板将被写入XML文件。

当系统出现重大升级时，模板与系统可能出现冲突，可根据经验修改XML文件来修复模板文件。

Lerx采用标签来定义变量，模板的设计应以常变化的数据用标签来替代，一些不常变化的数据如导航菜单等等则应直接用HTML来展示，在V2版本中，一些不必要的功能被直接抛弃，如上面所提的导航菜单，这样做的目的是为了加快网站执行速度，不让系统去处理那些并不一定需要处理的功能。

Lerx内置了大量数据接口，可以在网页用利用AJAX或JS来调用。

二、操作方法

1.后台选择相应的风格模板

2.点击需要修改的风格模板右边的编辑。

3.在模板的变量列表中选择需要修改的变量，点击右边的详情进行查看或编辑。

4.修改变量后，点击提交即可。

注意：

修改后将立即生效。

请注意做好模板的备份工作，以防无法恢复。

在操作大容量代码时，建议将变量内容复制进其它文本编辑软件如记事本、EditPlus或UltraEdit等软件进行处理完毕后再粘贴进来进行提交。

二、约定

Lerx以{$$data$$}的格式来存储标签。

data是标签名称，中间可能有英文半角逗号（,）或其它一些特定字符。

据此，我们进行以下约定：

标签：

指类似于{$$data$$}形式的字符串，该字符串在系统执行时会被相应的数据取代。

模块变量：

指各模块中的存储的各键的名称，如下图。

三、建议

1.应使用现有的模板复制为新模板后再修改，以免一些模块变量被漏写。

2.在修改模板之前，应将模板复制一份或导出，以防修改错误无法还原。

3.可以参考现有模板的代码来改写新模板。

4.应首先设计通用部分及Public子模块的代码

四、模板说明及执行顺序

V2版本模板一般分为通用模块和各子类模块（抽奖系统由于较简单，未设定子模块）。

以下说明以门户模板为例。

1.执行顺序

前台系统执行时，除play.action及上传和附件修改这几个独立页面外，其它页面均首先会读取public模块的htmlTemplate模块变量。

这一模块如果为空，将输出为空白，所以这一模块变量内容至少包含标签{$$htmlBody$$}。

大多数网站有html首尾都差不多，所以官方发布的模板为了减少模板代码，将{$$htmlBody$$}定义为html的中的内容。

然后根据页面的不同，会读取相应的子类模块。

比如，首页会读取index模块，文章页会读取article模块等等。

在子模块中，如果未定义模块变量，将自动读取public模板的模块变量及通用设置中的模块变量。

比如：

如果网站的css是相同的，那就可以放置在public的css标签中，所有页面将都读取这个css。

执行流程见下图。

s

2.每个子模块设立了specialCode1-4四个标签，用于放置该页面的特殊代码。

例：

网站设计时大体css是相同的，但首页、分类页、文章页的css会有自己独特的部分。

利用specialCode1-4可以轻松解决这个问题。

解决方法：

将完全公用的css代码放置在public的css区域，再在这css代码中插入{$$specialCode1$$}标签，然后在相应的页面的specialCode1变量中输入特有的css代码。

比如首页就在index模块的specialCode1中输出首页特有的css代码。

3.通用设置中设定了publicCode1-4，可以在任何子模块中进行引用。

如，上例中的可以反过来进行，或者其它一些通用的代码。

五、模块变量及标签详义

系统性标签

{$$charset$$}字符集，从配置文件resourcesApplication_zh_CN.properties中获取

{$$fullSiteName$$}站点全称

{$$shortSiteName$$}站点简称

{$$siteName$$}站点名称，智能标签，以简称优先获取

{$$welcomeStr$$}站点欢迎词

{$$siteUrl$$}站点Url，不含http前缀

{$$keyWord$$}网站关键字

{$$description$$}网站说明性文字

{$$actionErrors$$}错误信息

{$$mainTitle$$}当前应用标题

{$$cssStyle$$}css代码

{$$htmlBody$$}HTML主代码

{$$top$$}顶部代码

{$$footer$$}底部代码

{$$searchAreaCode$$}搜索区域代码

{$$key$$}搜索关键字

{$$webPageTitle$$}页面标题

{$$locationSplitStr$$}网站位置标识符

{$$publicCode1-4$$}共用代码1-4，如{$$publicCode1$$}指共用代码1

{$$specialCode1-4$$}模块指定代码1-4

{$$memberPanel$$}用户面板代码

{$$contextPath$$}当前应用路径，应在所有路径如资源文件前加此标签

{$$contextHost$$}当前应用URL

{$$year$$}服务器当前时间的年份

{$$htmlRoot$$}HTML文件的根目录

{$$executeTime$$}页面执行时间

{$$lerxCmsCurrentVersionNumber$$}当前Lerx的版本（项目编号）

{$$lerxCmsCurrentVersionBuild$$}当前Lerx的版本（建立时间）

以上标签会在页面执行结束之前被替换成相应的字符串。

其中，{$$contextPath$$}的使用会大大减少网站资源文件的错误率，在网站迁移时会更有用。

门户

Ⅰ通用

1.styleName

该标签为系统性标签，为模板的名称。

修改模板的名称即修改此值。

注：

系统性标签在模板中并无实际应用效果。

2.author

模板作者，系统性标签。

3.description

模板说明，系统性标签。

4.locationSplitStr

网站位置分隔符。

默认为-，仅管定义为网站位置分隔符，实际使用中也可以作为其它用途。

如下图。

参考：

-或→等等

5.hrefLineFormatStrOverAll

默认的数据行格式。

一般如果在模板中没有找到对应的数据行格式，就采用本格式。

参考：

在该标签中存在多个内置标签。

注：

内置标签指系统会根据标签内容自动生成相应的数据，切不可随意修改内置标签格式及内容。

{$$id$$}指数据的ID值。

{$$href$$}是当前数据的链接URL地址。

{$$title$$}指数据显示文本。

一般为文章的标题或精简标题。

此标签为智能内置标签，系统会根据文章的主标题和精简标题来自动生成。

生成规则为：

精简标题优先及根据栏目限定的标题长度以为文章中的标题突出属性来自动生成。

{$$originalTitle$$}文章原始标题。

{$$hrefLine$$}该内置标签为简化标签，可直接生成title。

{$$alt$$}指提示文本，即鼠标移动到当前位置时的弹出提示文本，该标签在标题长度不足时会自动显示，标题完整时则无。

{$$addTime$$}是指数据的时间即文章的新增时间。

{$$addTime@dateFormat$$}自定义时间格式。

以2012年10月8日15时27分40秒举例：

{$$addTime@yyyy-MM-dd$$}效果：

2012-10-08

{$$addTime@MM-dd$$}效果：

10-08

{$$addTime@yyyy-MM-ddhh:

mm:

ss$$}效果：

2012-10-0815:

27:

40

{$$addTime@yyyy-M-dhh:

mm$$}效果：

2012-10-815:

27

{$$member$$}发布会员

{$$author$$}作者

{$$authorUrl$$}作者网址

{$$authorEmail$$}作者Email

{$$authorDept$$}作者单位

{$$mainImg$$}标题图片URL

{$$thumbnail$$}缩略图URL

{$$imageUrl$$}图片URL，该标签为智能标签，以缩略图优先的原则显示。

全无则取系统内置默认图URL。

{$$mainImgExplain$$}图片说明文字

{$$views$$}文章被浏览次数

{$$synopsis$$}文章简介。

该标签智能标签，当没有输入简介时，将将系统定义的截取长度自动生成无格式代码的文字。

{$$editCode$$}数据行编辑代码

{$$state$$}文章审核状态标记代码。

6.hrefLineFormatWithSnStrOverAll

默认的带序号数据行格式。

一般如果在模板中没有找到对应的数据行格式，就采用本格式。

参考hrefLineFormatStrOverAll，本标签增加了一个内置智能标签{$$sn$$}用于显示序号。

7.mediaPlayCode1-3

播放器1-3代码。

该标签存在内置标签{$$mediaUrl$$}，指媒体文件的URL地址。

Lerx可以提供三种播放器的代码。

可以任意设定其中的某一播放器代码，如1中输入flv格式的播放器代码，2输入wmv格式的播放器代码，3输入rm格式的播放器代码。

在资源文件resourcesStyle_zh_CN.properties中，有三个键值对进行指定。

需要用户根据这里相应的播放器代码设定来指定显示名称。

默认设置为：

lerx.mediaCodeFormat1=flv

lerx.mediaCodeFormat2=wmv

lerx.mediaCodeFormat3=rm

8.mediaPlayOuterLayerCodeForArtPage

文章页播放动作代码，媒体的播放形式有两种，一种是在当前文章页进行播放（一般只有一个媒体文件），一种是利用附件形式打开新窗口进行播放（见下一变量）。

内置标签：

{$$playerMainBody$$}指播放器代码，即mediaPlayCode1-3中的代码。

{$$tid$$}指文章的id。

9.mediaPlayOuterLayerCodeForAttaPage

附件页播放动作代码。

注意，这里是模板中一个完整的HTML文本。

即整个网页的所有HTML均需输入。

10.attachmentLineShowForImg、attachmentLineShowForDownload、attachmentLineSh