Lerx网站系统使用说明书
一、 系统简介
lerx网站系统是一个基于JSP+MYSQL的松散结构型整站程序，可以跨平台使用。系统依据数据与页面风格完全脱离的设计原则，所有HTML标记将都由用户通过配置模块风格等方式来产生输出，从而给用户建立各种风格及个性强烈的大型网站提供了稳固的支持。主要包括：文章新闻系统、论坛系统、个人空间系统、投票系统等等。
开发测试环境：红旗Linux4.0-6.0SP2及REH3、4、5；JDK 1.5.0以上版本；Tomcat 5.X-6.0.18(可通过mod_jk1-2.so集成于apache 2.0)、MySQL3.2.3-5.1.28版本。Windows环境可以参照上述参数进行配置(建议采用Linux操作系统以获得系统运行的稳定性和高性能)。
二、 安装
1、 将upload下所有文件上传至支持JSP的网络路径中。
2、 linux环境下将除WEB-INF以外的所有目录权限设置成755。
3、 安装MySQL数据库(建议同时安装phpMyAdmin，方便操作数据库)。
4、 修改config_db.jsp配置数据库连接参数、或执行第4步进行生成config_db.js文件。
ps_server="XXX.XXX.XXX.XXX"; //数据库服务器地址
ps_port="3306"; //数据库服务器连接端口
ps_DBPool="pool_Lerx"; //连接池名称(可选)，如果在Tomcat中配置了请定义
ps_DB="YourDB"; //数据库名称
ps_ConnUser="root"; //连接数据库用户帐号
ps_ConnUserPassword=""; //连接数据库用户帐号密码
ps_AdminSession="admin_www.yourdomain.com"; //Session键值，建议用amin_+"你的域名"以保证唯一性
5、 在web界面下输入/install/install.jsp建立数据库并进行数据库初始化。
6、 删除/install目录及其下面所有文件。在web界面下输入http://www.yourdomain.com/admin/m_login.jsp进入后台进行各种配置及设计（如图(1)。默认管理帐号及密码：lerxadmin。
图(1)
三、 主要文件说明
|
序号 |
文件名 |
类别 |
说明 |
|
1 |
config_db.jsp |
模块 |
数据库配置 |
|
2 |
const.jsp |
模块 |
常用变量定义 |
|
3 |
conn.jsp |
模块 |
数据库连接 |
|
4 |
include.jsp |
模块 |
模块加载 |
|
5 |
index.jsp index.html |
页面 |
网站首页 |
|
6 |
index_html.jsp |
模块 |
静态文件index.html的生成 |
|
7 |
class.jsp |
页面 |
分类页 |
|
8 |
list.jsp |
页面 |
内容页 |
|
9 |
newlist.jsp |
页面 |
最新文章列表，可通过多种参数来选取 |
|
10 |
article_add.jsp |
页面 |
文章增加 |
|
11 |
article_edit.jsp |
页面 |
文章修改 |
|
12 |
user_reg.jsp |
页面 |
用户注册页面 |
|
13 |
login.jsp |
页面 |
用户登录页面 |
|
14 |
toplist.jsp |
模块 |
数据提取 (文本方式)，用于js文件中的提取 |
|
15 |
toppiclist.jsp |
模块 |
数据提取 (图文方式)，用于js文件中的提取 |
|
16 |
myarticles.jsp |
页面 |
我的文集 |
|
17 |
search.jsp |
页面 |
搜索页 |
|
18 |
siteinf_setup.jsp |
模块 |
网站系统信息提取 |
|
19 |
styleinf_setup.jsp |
模块 |
模板信息提取 |
|
20 |
space.jsp |
页面 |
个人空间页面 |
|
21 |
spacecp.jsp |
页面 |
个人空间设置 |
|
22 |
sindex.jsp |
页面 |
空间首页 |
|
23 |
bbsindex.jsp |
页面 |
论坛首页 |
|
24 |
forumdisplay.jsp |
页面 |
论坛分类页 |
|
25 |
viewthread.jsp |
页面 |
论坛帖子查看页 |
|
26 |
vote.jsp |
页面 |
投票页 |
|
27 |
vote_list.jsp |
页面 |
投票结果页 |
|
28 |
getcode.jsp |
模块 |
验证码 |
|
… |
… |
|
|
四、 系统约定
本系统采用{$$tag$$}来标记变量和标签，极少数用户页面采用[[tag]]。所有标签均需程序文件支持，不支持自定义标签。
本系统对所有字符大小写敏感。
五、 后台管理
Lerx管理后台分为左右两部分，左侧为功能选择，右侧为具体设置页面。分为系统管理、会员管理、风格模板管理(包含网站、论坛、个人空间)、内容管理、论坛管理、投票与抽奖管理、友情链接管理及其它设置等多个主要管理模板。
由于使用MySQL数据库，建议使用PhpMyAdmin管理平台来管理数据库，可以在const.jsp中将ps_DBManageUrl的值设置为PhpMyAdmin的管理地址。
图(2)
1． 系统管理
系统管理主要配置网站基本信息、管理员信息，执行SQL命令及数据库的管理链接。
网站基本设置用户设置网站的基本信息。建议将网站Session键值设置成网站域名，以保证该值的唯一性。如果定义了限制可访问的IP范围，除此范围内的客户端将不能浏览到该网站的内容，但静态页面除外。设置格式为：<xxx.xxx.xxx.xxx>-<xxx.xxx.xxx.xxx>，例如：<58.226.230.1>-<58.226.230.254>。注意，前一个IP的值要小于后面一个IP的值，以免发生错误。
说明：首页默论滚动公告文字为不常使用设置，建议不设置。网站URL地址请不加http://，网站Session键值最好采用域名或URL地址，以保证该值的唯一性。
图(3)
2． 系统管理员设置
本系统前后台管理分离，但系统管理员在登录后台状态下可以管理前台发布的文章，但不能管理个人空间及论坛。系统至少需要一个系统管理员，删除最后一个管理员的行为将被禁止。可以通过图(4)的界面进行增加管理员的增加、编辑和删除操作。
提示：增加太多的系统管理员将对系统安全带来隐患，其次，系统管理员可以删除其它的管理员帐号，所以建议慎重增加系统管理员帐号。
图(4)
3． 操作记录
本系统对绝大多数的对数据库的操作行为均进行记录备查（包含前后台操作记录）。
图(5)
提示：可以将SQL记录复制到记事本再连同其它信息来综合分析每一个操作的详细情况。
4． 数据库管理
该项为外部链接，可以采用phpMyAdmin的管理地址，在const.jsp中对ps_DBManageUrl变量进行设置。
六、 会员管理
会员管理包括用户组管理、用户管理及用户功能选项。对用户权限的控制主要通过用户组的权限码设置来进行。用户功能选项中包括对用户行为的控制，是系统设置核心的一部分。
图(6)
1. 用户组管理
根据需求设定不同的用户组，再对用户组的权限码进行设置，可以对用户的操作权限进行有效的开放和控制。
权限码用小写字符及数字标记，以“,”(注意为英文半角字符)分隔。(如图8)
如果采用日发文数量限制模式，该用户组在设置了限制发文数的栏目中发表文章的数量将受到限制，对应的设置在“内容管理”的“栏目管理”中。
用户组特定html为自定义的html代码，可以在相应的页面中当该组用户登录时显示。如：前台管理员登录后，可以用html编写一个超链接代码链接到后台管理登录页面。
通过认证问题及答案设置，可以让用户自行认证归属于相应的用户组，该操作通过文件authentication.jsp?gid=用户组id号来进行。用户必须回答两个问题才能通过认证。authentication.jsp文件可以在风格模板设置中设定该页的样式。
图(7)
提醒：对用户组权限的设置应该遵循按需开放的原则，避免用户权限过大，并尽可能避免权限交叉。
权限码一览表
|
序号 |
权限码 |
说明 |
备注 |
|
1 |
0 |
管理员 |
无须其它任何附加权限码 |
|
2 |
p+数字 |
版块管理，数字为栏目ID号 |
如：拥有p23权限码的用户组内所有用户将对ID号为23的栏目文章拥有管理权（包括编辑、删除、审核等等） |
|
3 |
a+数字 |
文章增加权限数字为栏目ID号 |
同上（只含文章增加权限） |
|
4 |
f |
公告权 |
只有网站首页采用自动公告标签才生效。 |
|
5 |
s |
个人空间权限 |
|
|
6 |
badmin |
论坛管理员 |
|
2. 用户管理
通过该项，可以对用户大部分个人资料进行查看及修改。
“发文显示栏目掩码”为用户自定义项，如：某用户组拥有众多栏目发布权，但其中的一用户只想在其它的一个或某些栏目发布文章，该用户就可以在个人资料中的本项中加入栏目id(用“,”隔开)，这样，当该用户登录发表文章的时候，栏目列表中将只会出现他选定的栏目。清空该项将恢复用户组默认值。
3. 用户功能选项
该项为系统设置项，对所有用户组及用户都将产生影响。其中，评论控制设置后为系统默认值，具体栏目或个人空间可以自行设定，如果选择为系统默认，将从本项中的设定中取值。
可以设定一个用户组，再在本项中的“通过新用户注册自动归属用户组”中选择为该组，使得新注册用户能拥有相应的权限，减少系统管理的难度和工作量。
图(8)
七、 风格模板管理
本类包括主站风格模板和个人空间及论坛风格模板，是网站建设的核心部分。操作本项时应遵循“不懂不改”的原则，并应及时做好备份，以免在操作时发生意外无法恢复。
由于本系统所有程序均无html输出，因此网站的样式和内容均是通过本项设定来输出的，所以通常的做法是美工师及前台代码师生成一个静态页面（该页面包含了网页的所有html代码），最后由后台管理员进行tag标签（用{$$tag$$}约定样式）插入替换，再保存到风格模板中的相应模板中。
1. 主站风格模板
图（9）
点击“编辑”进入模板详细内容清单。点击复制可以复制一份模板进行备份或开发。
图（10）
图（11）
一部分杂项可以点击上方的“其它更多”来设置。下方的模块点击“内容详情”可以进行修改，点击示例可以查看示例内容和说明。可以在图(12)处选择目标页面来产生相关的模板列表进行编辑。
图（12）
本项比较复杂，用户可以登录Lerx官方网站及官方论坛与我们进行交流。
2. 个人空间风格模板
个人空间风格模板与主站及论坛风格相互独立。但个人空间中的设置等公共页模块在主站风格模块中。其中，通过设置“个人空间预设共用代码”可以减少个人空间风格的开发量。
本系统不仅仅采用CSS变换样式的方式，对每个空间风格亦可进行模块的设置修改。空间用户还可以通过个人空间设置来寻求不同的空间样式和内容版块。个人设定的风格系统将优先采用。
图（13）
提醒：个人空间的总框架输出并不采用主站系统的总框架输出，而采用在主站当中使用的风格模板中的SpaceHtmlTemplate标签变量来输出(区别于主站的IndexHtmlTemplate)。
图（14）
3. 论坛风格模板
论坛风格模板的操作与主站风格模板的操作大致相同。但其中有许多tag标签与主站并不完全相同。
Lerx官网和论坛中也开辟了相应的版块对本内容进行交流。
图（15）
八、 内容管理
内容管理主要包括主站栏目及文章及附件进行管理。其中，栏目的设定管理是内容管理的核心。
本系统支持栏目无限分层。
图（16）
1. 栏目设置
在页面最下方可以新建栏目，点击修改对栏目进行详细的设置。
栏目公开将对所有访问者开放，如果不公开该栏目及其下所有文章只对注册用户且有用户组归属的用户登录后开放访问权限。
栏目定义为分类后该栏目下将无法发表文章。
通过设定“限制本栏目可访问IP”可以将某些栏目限制在一定范围内进行访问，比如公司的内部资料等等。格式请参照系统管理中的格式。
设置了链接目标，本栏目在导航中的URL将直接跳转。
可以在栏目风格中进行设置，使得栏目之间的样式可以完全不同，这需要在主站风格模板中建立多个风格模板来进行。比如，体育频道栏目与娱乐频道栏目的页面可以通过这种方法实现完全不同的效果。
通过设定“限制模式中限制发文数”和“用户功能选项”中的设定来限制某些用户组在本栏目中的日发文总数。
图（17）
时间格式为“yyyy-MM-dd mm:hh:ss”（注意M为大写）。中间的“-”和“:”可以自行设定，如“yyyy年M月d日”。
标题列表行格式用于处理一些特殊处理的样式，比如图片列表等等。
自定义发文审核方式可以定义本栏目的发文审核方式。
如果想在首页或在上级栏目页显示本栏目的文章列表，则必须在首页Top列表或上级分类栏目Top列表中选是，并且定为显示个数。
首页专题主要用来处理一些图片专题，如在首页显示图片新闻。选中该项后必须在风格列表中对“NavJavaScriptBody”、“NavJavaScriptSingleLoopBody”或“NavFlashArrayLoopBody”以及针对javascript代码情况对TopListFormat1-4进行赋值。
栏目特定html用于在栏目中输出本栏目的特定html。
2. 栏目显示顺序
选择父栏目提交后，可以通过右边的上下箭头对栏目的位置顺序进行调整。点击下方的“点此链接将全部自动修正重排”将对站点的全部栏目顺序进行修正。
图（18）
3. 文章管理
用于产生最新文章列表，对文章进行编辑、删除、审核等操作，但建议采用前台处理的方式，可以用newlist.jsp来产生文章列表（通过参数传递，可以有全部文章和待审文章两种模式）。
4. 上传附件文件管理
通过本功能，可以按指定日期，对用户所上传的文件进行查看下载或删除。
九、 论坛管理
论坛管理主要包括版块设置、版块顺序、论坛规则和积分组设置。本系统中的论坛功能以实用为主，抛弃了一些不必要的论坛功能。主要有发帖、回帖、置顶、屏蔽、精华、引用等功能。用户组采用按积分进组方式。论坛界面和主站及空间一样，所有html输出均由风格模块进行定义。
图（19）
图（20）
设置及操作与主站内容管理中的栏目设置类似。定义为分类的栏目也将不可以在其下直接发帖。根栏目被系统直接定义成分类版块。用户总积分将根据发帖、回帖、加入精华及删除行为实时变化，用户组随积分动态变化。在系统用户组的用户才可以发帖回帖，对论坛其它使用没有影响。
十、 投票与抽奖管理
本系统投票及抽奖模块为独立模板，内置风格界面设定功能。即投票及抽奖界面与网站中的其它所有页面均无风格或版块联系。例如图（21）及图（22）投票页及图23结果页。可进行网上报名。
图（21）
图（22）
图（23）
投票及抽奖相关页面文件列表及说明
|
序号 |
文件名 |
说明 |
备注 |
|
1 |
vote_sign.jsp?id=+投票ID号 |
网上投票页 |
|
|
2 |
vote.jsp?id=+投票ID号 |
网票页 |
|
|
3 |
vote_list.jsp?id=+投票ID号 |
投票结果页 |
|
|
4 |
vote_record_list.jsp?id+投票ID号 |
投票人信息 |
如果需要保密，请改名后使用 |
|
5 |
draw.jsp?id=+抽奖id号 |
抽奖页 |
|
点击投票列表右侧的“编辑”，将可以对投票规则和界面风格进行设定。点击“内容”，可以编辑具体投票项目。
图（24）
本系统提供了丰富的投票限制规则，并可根据计分规则实时计分。
如果设定了最大投票数，并且强制，则投票人投票时必须选中最大投票数才可以投票成功。时间的设定请按yyyy-MM-dd hh:mm:ss进行输出。
和其它风格模板一样，所有投票页界面都必须进行html设定。
图（25）
抽奖是根据投票来产生的，可以输入多个投票ID，将从投票人列表中随机产生设定的中奖人数。
电话号码屏蔽将从首位开始，按设定的数值进行屏蔽。
说明：设定后应进行测试，所有功能测试完工后才能置放于网上进行投票及抽奖。
图（26）
十一、 友情链接管理
友情链接管理模板分为友情链接类型和链接管理两个方面。可以在网站首页得用{$$LinkCode,类型ID号$$}标签来在相应的位置显示友情链接。
十二、 附加说明
由于本系统程序无主动html输出，所有html均是从数据库中取用户的设定代码再进行tag替换来输出。因此，本系统的所有用户页面如果没有设定代码是空白。