网站内容管理系统使用说明书.doc

Lerx网站内容管理系统说明书Lerx网络科技2012/12/141. 概述Lerx网站内容管理系统（以下简称：Lerx）是对各门户网站建设的需求进行长期深入分析，并结合成功实施一些网站建设项目的实践经验，而推出的专门面向互联网站内容编辑与发布的应用系统，主要包括以下模块：用户及用户组管理、门户系统、问答系统、投票及抽奖系统、论坛（开发中）、博客（个人空间，开发中）等等。开发这套CMS系统旨在利用多年管理庞大的后台信息系统的经验，帮助政府机关和企事业单位规范其网站后台信息流程、统一数据存储格式、减少网站维护的投入、加强信息披露的权限管理。它的出现将大大减轻建立各类信息网站的复杂性，并使网站的运营管理、内容维护变得易如反掌。Lerx主要有以下特点： Java 系统，可跨平台运行 SSH2框架、支持大多数常见的数据库 文章管理在前台依据权限操作，避免过多用户进入后台导致安全问题 模板模块化、快捷的模板导出导入功能 支持静态生成 强壮的注册、发布等安全机制，有效防止注册机 密码二次MD5加密 支持跨域上传 2. 安装2.1. 安装环境Lerx可安装于各Windows及Unix/Linux平台以及Mac平台。实践中在Unix/Linux环境中将获得更高的性能。在安装Lerx之前，应首先满足以下条件：1. 已安装或有相关数据库2. 已安装JDK 1.6以上版本3. 已安装Web及Java容器服务器，推荐使用Nginx与Tomcat进行整合安装4. 足够的磁盘空间，使用静态功能将占用更多的空间2.2. 安装步骤1. 将安装包解压2. 将安装包中的upload中的所有内容拷贝到网站根目录下3. 将安装包中的lib中的jar文件复制到网站根目录下的WEB-INF下的lib文件夹中，如果仅有一个网站或该服务器上的其它Java项目采用的Struts2、Hibernate、Spring版本与本包提供的相同，可将jar包拷贝在Java容器的lib 文件夹内（如Tomcat的lib目录下，注意：不可在WEB-INF/lib及Java容器的lib目录中同时存在相同的jar文件）4. 安装数据库支持驱动，安装包的lib目录下的mysql文件夹内提供了MySQL的驱动文件，请按步骤3同样拷贝至相关的目录5. 修改网站根目录下的WEB-INF/classes下的perties文件，配置数据库连接6. 修改网站根目录下的WEB-INF/classes下的resourcesApplication_zh_CN.properties配置文件，主要修改以下参数： lerx.serverPort 改为服务器的web端口，如果仅仅使用了Tomcat，可以置为0让系统自动检测或改为Tomcat使用的相应端口，如8080。如果进行了整合，比如Nginx或Apache使用80，Tomcat使用8080，请一定要将此处改为80lerx.adminFolder 根据你的管理目录进行设置，默认的管理目录是admin，为了达到更安全的效果，可以将admin目录改为其它的名字，目录名要与本处一致lerx.default.admin.username及lerx.default.admin.password，后台管理的默认密码，一般在进入后台并加入后台管理员帐户后，应将此处置空。如果忘记后台管理员用户名和密码，可在此处重新填写后重启Java容器以达到重新能进入后台的效果。lerx.defaultReturnSiteUrl，如果使用了首页静态功能，请将此值修改为网站的根路径，如一个斜杠“/”就可以了。lerx.createStaticSafeStr，这个值也要修改。该值的作用是生成静态时使用的安全键值，以防不法用户利用静态功能不断让服务器执行静态化工作，影响服务器的性能7. 修改网站根目录下的WEB-INF/classes下的hibernate.cfg.xml，将create前后的注释标记去除。该参数的功能是让系统自动根据配置在数据库中建立相关的表。首次运行建表结束后，应检查数据库的表是否成功建立，一旦成功建立，请将此注释恢复，以防下次启动时数据库的表被重建以及数据被清空。8. 如果采用静态化措施，还应修改applicationTimerTask.xml及applicationContext.xml配置文件。将applicationTimerTask.xml中的以下内容根据网站的具体路径及步骤6的第项的静态安全值进行相应的修改，将applicationContext.xml中的!- -的注释删除。9. 删除项目日志，比如Tomcat的logs下的所有文件，重启Java容器，观察logs下的重新生成的日志内容，确定系统是否成功安装并启动。（注意：成功后务必将步骤7中的注释恢复，即将自动建表功能无效）10. 如果进行了整合，请对WEB-INF进行保护，如Nginx可将该目录提交给Java容器处理。2.3. 初次使用1. 初次使用时请务必进入后台的网站基本设置进行设置并提交。一旦提交，将在网站的WEB-INF目录下自动生成一个加密文件，文件名由配置文件resourcesApplication_zh_CN.properties的lerx.hostSecFile指定，默认为：curLerxHost.jsp。如果该文件不存在，系统将无法正常运行。2. 导入门户模板。并在网站基本设置中选中该模板，点击确定保存。3. 输入网站首页地址，察看网站是否正常输出。3. 后台管理3.1. 网站系统设置3.1.1. 网站基本设置点击上图所示链接进入网站基本设置。其中，网站名称、网站Session键值、网址或域名、当前站点使用默认风格模板 为必填项，否则网站可能会出现问题。如下图。限制可访问的IP范围格式如：-54,3.1.2. 后台管理员设置如上图所示，点击“管理员设置”进入管理员设置，可以进行增加、删除、修改、禁用等操作。说明：本系统的前后台用户是分离的，即后台管理员只管后台，前台用户与此无关。3.1.3. 其它设置如果采用了自动邮件功能，请务必在此处填写相关信息。本设置中，新注册用户审核邮件正文、问答系统新增条目邮件正文、问答系统反馈邮件正文可不填写。在WEB-INF/conf目录中有三个文件对应本处内容，如下图。如果此处填写了，系统则取本处内容，如果本处为空，将读取上述三个文件的相关内容。可以修改这三个文件的内容获取显示效果。允许上传的文件类型及敏感词过滤也可不填，在配置文件中也有相关的配置，如果本处填写了，则取本处内容。在配置文件resourcesUploadFiles_zh_CN.properties的lerx.uploadTypeAllow.default处和resourcesMessage_zh_CN.properties的lerx.filterWords处分别有值对应本处内容。3.2. 用户及用户组管理本系统用户分前台用户及后台管理员，相互独立。本处所说用户及用户组指前台用户。用户的权限是由用户组指定的。所以，当要指定用户权限时，应设定一个有相关权限的用户组，然后将该用户归属至该用户组即可。3.2.1. 用户组管理如上图所标，点击“用户组管理”进入相关的管理界面。在新建用户组时，可不输入权限码，待新增成功后再修改相关的用户组的权限属性。需要说明的是，用户组名称仅仅是符号定以义，比如，用户组名称可以定义为“管理员”，但这并不代表该用户组中的用户可以对网站可以进行管理，系统而是依据该用户组的权限码来判定用户的相关权限。所有此处的用户组均对后台无任何权限。可以删除、禁用及修改用户组。修改用户组，点击“修改”。在用户组的修改页面中，可以修改用户组的显示名称、用户组状态，如果状态为禁用，则该组下的所有用户将无法登录及其它相关操作。如果采用了日发文限制，可以与相关栏目的日发文限制进行联动。私有html中可以输入一些特定代码，在用户的面板中进行显示。例如：某一用户组，需要给其一些特定的功能，则在此中输入功能的HTML标签（如链接地址显示），在模板中的用户登录后代码中设置标签，即可显示功能输出。点击权限码右侧的设置可设置权限码。如下图。Lerx的用户组权限（前台）都定义在权限码中。规则如下（注：通过选择可以自动进行权限码生成，并不需要手工输入）：0最高权限f公告权a发表权p管理权v投票系统管理权q问答系统管理权其中，a、p、q用与栏目id组合的方式来达到储存权限的目的。如：a16代表在栏目id为16的栏目中该用户组所属用户可以发表文章。p20代表该用户组所属用户可以管理栏目id为20的栏目中的文章。q5代表该用户组可以管理问答系统栏目id为5的栏目，该权限主要为回答提问。a0代表可以在任何门户栏目发文，即全部发表权。因为p0其实就是0，就是全部管理，所以没有p0。q 如果仅为一个字符q，则为问答系统管理员，可以在任何一个问答栏目中回答。v该权限设定后，可以管理任何投票和抽奖，相当于投票抽奖管理员。权限码的组合方法是用英文逗号（,）隔开。存储权限码时系统一般会自动检测，会清除无用的权限码。比如：定义了为管理员，但又定义了其它一些属性，系统会只取0为权限码。再如：定义了全部发表权，又定义了部分栏目的发表权，系统会只取a0为权限码。说明：所有权限码均为英文及数字小写半角字符。否则将无效。在权限码选择框中，可以拖动右侧的滚动条查看所有栏目。如下图点击确定，将生成权限码并自动复制在权限码的输入框内。保存即可。在Lerx中，在发表文章和修改文章的时候系统会根据用户的权限自动生成一个门户栏目显示码，即只显示用户有权限的栏目。这样做是为了避免栏目过多而引起用户查找不方便。这个显示码是隐藏的，每次保存用户组时都会自动进行处理。如果用户的显示码有问题，可以点击用户组列表下方的“全部修复”来自动修正显示码。3.2.2. 用户管理用户管理页面中，所有用户将按注册时间倒序进行显示，可以翻页显示。如下图可以按用户名排序，如下图在查找框中输入用户名，可以快速查找该用户。在下面的快速输入用户中，可以输入用户名进行快速录入。本系统中，用户的增加可以通过此处的快速增加录入，也可以利用用户自由注册的方式，还可以利用工具中的数据导入功能进行批量导入。修改用户属性（包括修改用户的所属用户组），可以点击用户列表右侧的修改进入用户资料界面。用户资料中，如果不想修改密码，请将密码框置为空。在用户所在用户组一栏中，可以将用户的所属用户组进行调整。注意：一旦修改了用户的所属用户组，则该用户将获得该用户组的所有权限。如下图。3.2.3. 用户功能选项该配置页面中，可以对用户注册登录及评论等操作进行设置。自动审核时，首先要对邮件服务的配置进行设置（见3.1.3）。只有对邮件服务及注册时邮件文本进行了正确的配置，自动审核才会有效。并且要同时打开“开放注册”、“新用户注册自动审核验证”、“自动发送邮件到登记邮箱进行确认”三个选项。一般应该设定一个权限较小的的用户组让通过审核的用户自动归属到这个用户组。切记不可采用有管理权的用户组，否则用户审核后就可以删除及审核文章等相关操作。如上图的“注册用户”这个用户组的权限码只为a0，就是全部发表权，也可以选择一些栏目的发表权进行定义。3.3. 风格模板管理风格模板对网页的展示至关重要。本章主要讲解模板的建立、删除、复制、备份等管理。模板的设计请参见Lerx模板设计手册。Lerx的模板主要有主站（即门户）、个人空间、论坛、问答系统、投票、抽奖等项目。如下图。点击需要处理的模块，将进入风格模板列表及新增、导入页面。在该页面中，可以快速增加风格模板，但此时的风格模板的内容是空的，并不起任何作用。一般我们可以采用一份自己满意的模板进行复制，然后将该模板设定为网站采用的模板，再对模板的标签内容进行修改，最终达到自己需要的网站风格样式。有时风格模板太多，引起查找不便。我们可以将不需要的或不经常用的模板进行隐藏。当需要的时候，再点击显示所有将其显示出来。如下图（默认显示为不显隐藏模板）。模板的导入可以导入他人提供的Lerx模板（注意：本功能无法导入非Lerx的模板）。还可以对模板进行复制（含复制为新模板及导入功能）。点击“复制”，在输入框内可以输入新的模板名称。点击下面的导出为文件，可以将模板导出与他人共享。如下图。说明：模板文件是xml格式的文件，该文件并不包含模板中所引用的资源文件。所以，在发布或提供模板给他人时，应同时加入模板所引用的资源包。模板名称的修改可以点击“编辑”。点击“styleName”后的“详情”，修改后提交刷新即可。（说明：点击详情将进入模板的具体细节内容，这一部分的其它设置需在对模板设置了解的情况下进行，并应做好备份工作，操作要慎重）对模板的修改，应建立安全机制，比如，先复制一份，或导出，这样万一模板改错了，还可以恢复或查阅原先的内容，这样才能做到万无一失。3.4. 栏目管理（内容管理）3.4.1. 门户栏目设置栏目管理包括门户栏目和问答系统栏目。如上图。点击门户栏目设置，进入栏目列表及栏目编辑页面。该页面中，键值对为观测数据，为系统自动生成。该数值的解释如下：每个栏目有两个特别的属性，分别为左值和右值。无论什么情况之下，每个栏目的左角和右角一定在其父栏目的左值和右值之间。如果不在，说明发生了异常，直接后果是导致门户文章的提取异常。左值和右值是系统自动处理生成的。首页提取中的数据，三个从前向后分别意为：是否首页提取、首页提取的个数、首页提取时标题的截取长度（汉字及全角为两个长度值）。移动数据可以将该栏目下的所有文章移动至另一栏目下。 注意：移动数据后在系统中无法恢复（可通过数据库备份恢复）。点击设置进入栏目的具体属性页面。如下图。本设置中，“正常使用”属性勾选，该栏目才生效。栏目公开：当不公开时，该栏目需注册会员才可以访问。如果一个栏目定义为分类，刚无法在该栏目下增加文章。日最大发文数：如果此处值大于0，则限制了日发文数的用户组下的所有用户在本栏目下发表文章的日发文数不可超过。见3.2.1章内容。数据行数指本栏目内的文章列表的显示数据行数。IP范围参见3.1.1章。都可以混合，可以单ip，也可以用ip范围，不同的范围用英文逗号（,）分隔。通过对本栏目设定一个全新的风格模板，可以达到栏目页与其它栏目完全不同的显示效果。比如：新浪主站，栏目定为新浪体育，那么可以做一个新浪体育的风格模板，而在此处选择。这样个性化就出来了。注意：两个模板之间并不关联。如果不强制文章页面，那么文章页面的显示风格将按门户指定的默认模板的文章页格式进行显示。属性首页及属性父级页如果勾选，将代码在首页或其父级栏目进行提取输出。如果列表格式指定了，那将按此中的格式进行循环输出。显示所有子类文章勾选时，则可以在本栏目中出现一个所有子类列表。如下图。3.4.2. 门户栏目顺序在本页面中，可以选择根栏目，然后对其下的栏目进行显示顺序的调整。通过点击向上或向下的箭头完成。3.4.3. 问答系统栏目设置在该设置页面中，可以进行增加删除禁用等操作。如果栏目为分类，将不可以在此分类中进行提问。调整显示顺序可以按上图的显示点击进入顺序调整页。Lerx的问答系统可以对每个栏目进行区别管理。如果该栏目不是分类，点击修改将进入详情设置。如下图。当采用自动邮件回复时，首页要确定你的邮件服务配置是正确的，如果不想用系统的配置，可以在每个栏目下进行设置。即每个栏目的回复人及回复内容等都不一样。如果无回复内容，将自动读取WEB_INF/conf下的相关文件中的内容。3.5. 投票与抽奖管理3.5.1. 投票管理建立投票后，应同时导入投票的风格模板，并置为默认或在该投票中将风格模板指定为导入的风格模板。如果要使用按笔画排序，应导入汉字库（在安装说明中有说明）。被投票的子内容可以通过点击列表中的“内容”进行增加或修改。或者通过网上报名的方式（需在模板中提供网上报名的页面代码）。每个被投票内容额外提供了20个属性item1-item20。可以在模板中将其显示成不同的属性。如：item1可定义为头像地址，item8可以定义为被投票人的简历等等。如果点击清空，将清除该投票下的所有记录。3.5.2. 抽奖管理抽奖系统同样要设计抽奖的模板。由于该系统内容较简单，所有模板的设计内容也相应简单。可以对多个投票的投票人统一进行抽奖，此时可将投票的id号用以逗号分隔的连续id号字符串输入至投票id序列。如某一投票采用了多轮投票，但统一抽奖。排除以下结果的例子：比如抽奖结果分为不同类别，如十大热心网友和二十幸运网友。可以分别设定两个抽奖，当第一次抽奖结束时，可将抽奖结果输入到下一个抽奖的排除结果里，以免发生重复得奖的现象。3.6. 工具3.6.1. 数据导入工具本系统提供了多种导入方式。3.6.2. 文章统计可以按栏目、按时间段进行统计。重新计算是从数据库中逐一计算用户的发文情况并写入数据库。3.6.3. 手工静态提供了“首页及栏目频道”、“所有文章重新生成”、“未生成静态文章手工生成”三个功能。前提是网站已采取了静态化措施并已成功。建议尽可能少的进行手工静态操作。此举会加重服务器的负担。4. 前台操作Lerx的前台操作主要是文章发布及管理。而这些功能与模板有着很大的关系。比如，删除文章就要在模板中提供删除文章的地址。用户的面板界面也是由模板指定的。由于Lerx并没有将这一切集成在系统中，所以实现在界面的完全自由化。如，下面三张图的模板中的用户面板，其中登录采用了弹出窗设计。所有这一切都是由模板提供的。通过模板的设计，当用户在其拥有权限的栏目（注：必须是动态网页）中访问时，会出现管理的面板，如下图。由于有时采用静态化措施，默认的官方模板提供了一个静态转动态的开发，如下图的当前位置的最后一个项目，在栏目浏览时，点击该处将切换至动态页面，以便管理。通过ajax技术，可以实现多种管理功能，如下图在文章的下方显示了可管理的面板。另外在用户的文集及文章列表中均可以进行相关操作。5. 静态化5.1. 静态化机制说明网站的静态化可以加快网页首页的访问速度，并且更容易被搜索引擎抓取。因此，静态化措施对网站的整体性能的影响至关重要。Lerx的静态化主要包括以下几个方面：首页静态化、栏目页静态化（包括问答系统的栏目）、文章内容页静态化（包括问答系统的内容页）。其它的一些比如注册、登录、资料修改等并没有加入到静态化的序列中，如有需要，用户可以稍修改源码进行处理。首页及栏目静态是通过定时更新完成的，在配置文件中指定了时间及执行静态化的程序。门户文章内容页的静态化机制则不同，在文章形成即输完提交后，系统即生成了文章静态化所需的一些参数，比如静态文件所有的位置和静态文件名，但此时并不形成静态。当文章被审核通过时，这时静态化才开始执行。当文章被取消审核或被删除时，系统会同时删除已生成的静态化文件。对于问答系统来说，静态化生成是回复问题并且置问答为公开时才会生成。Lerx的静态化不是伪静态，而是真正的静态，所以，会占用服务器的磁盘空间。5.2. 静态化配置方法对于文章静态，只要在后台指定了全站静态，则文章被审核或问答被公开的同时，会直接生成静态文件。这里讨论的主要是首页和栏目页的定时静态配置。在配置文件applicationTimerTask.xml中，可以看到类似于下面的定义：http:/localhost:8080/lerx/createStatic.action?ss=lerx8888上面的http:/localhost:8080/lerx/createStatic.action即是处理首页及栏目页的程序。后面的参数是安全码，用途是防止服务器被恶意调用静态化程序。安全码写在配置文件resourcesApplication_zh_CN.properties中，当配置静态化时，这两处要一致。当然，用户也可以利用上述地址来进行手工静态化的处理。 在applicationTimerTask.xml配置文件中，指定了执行静态的周期时间等一些参数，并进行了说明性注释。这个配置文件修改完成后，并不代表可以进行静态化了。在另一个更重要的配置文件applicationContext.xml中，需要将以下的前后注释清除后（即删除）静态化行为才开始真正启动。!- -资源文件resourcesApplication_zh_CN.properties中定义了静态文件的文件名及目录格式及其它一些配置（建议除了目录格式和文件名格式化，一般不要修改）：lerx.htmlPath=html/静态文件的根目录lerx.defaultHtml=index.html/默认的静态文件名lerx.staticFileNameTimeFormat=HHmmssSSS/静态文件名lerx.htmlFilePathFormat=yyyy/MM/dd/静态文件的目录格式lerx.staticSiteFileFolder=s/门户静态文件目录lerx.staticSiteFileFolderOnNav=false/门户内容页静态文件是否在栏目静态目录内lerx.staticQaFileFolderOnNav=false/问答内容页静态文件是否在栏目静态目录内lerx.staticFileFolderOnRoot=false/静态文件目录是否在网站根目录下lerx.staticQaFileFolder=q/问答静态文件目录lerx.staticFileByNav=yeslerx.artStaticMod=true/显时时是否采用静态文件模式6. AJAX/API接口系统提供了丰富的AJAX或JS数据调用及安全验证接口。详细请见模板使用文档。7. 跨域上传Lerx提供了跨域上传的支持，因此可以通过一个专用的图片或文件服务器安装相同的Lerx系统（可以通过配置文件将其网站的其它功能关闭，如首页、栏目页、文章页等等）。因为默认模板采用了KindEditor在线编辑器，需要对编辑器的源码进行修改（Lerx的下载包里的KindEditor 4.1的JS文件已经进行了修改），具体配置方法请参照下面的文章。/html/s/technical/2012/09/27/094839545-250.html注意：跨域上传需两主机在相同的主域内，如：和，和之间无法实现跨域上传，这是由浏览器的安全机制指定的。8. 用户代码本模板可以自定义代码，通过ajax显示在网站上。比如：广告、天气预报等等。系统提供了对代码进行分类、按ID输出代码、按分类进行轮换及随机轮换输出的方式。实际应用1：可以定义一个代码分类为“广告”，然后在此分类中