itcastForum 论坛文档

1. 安装
准备
执行安装程序
安装成功
2.后台管理
版面管理
组管理
会员管理
搜索管理
系统设置
配置文件管理
3.版主管理
在主题列表页面中进行管理
在主题显示页面中进行管理
4.普通用户使用功能介绍
发表文章
搜索
个人资料
登陆
5.获得协助或支持
出现异常
联系我们

1. 安装

请先执行安装程序, 否则论坛不能正常运行

准备

解压论坛程序

从压缩包中解压出文件 itcastForum.war

启动 tomcat

把这个 war 包直接放到 tomcat路径/webapps/ 目录下, 启动 tomcat
这时会自动解压出一个文件夹, 名为itcastForum

执行安装程序

进入安装页面

访问这个地址: http://localhost:8080/itcastForum/install.jsp
itcastForum 是程序的名字, 也就是 itcastForum.war 解压出的文件夹
页面如下:

此论坛的持久层使用的是 hibernate, 即支持多种数据库, 目前有两个数据库类型选项

使用 hsqldb 数据库

当机器上没有数据库时, 使用这个选项, 这是一个 java 版的数据库
不需要输入有关数据库其它信息, 如上图所示.

或是使用 mysql 数据库

如图:
1.输入 mysql 数据库的连接信息和管理员信息, 分别是

2.输入数据库的名字, 并选择是否创建一个新的数据库

3.输入要创建的连接用户的信息

安装程序需要使用数据库管理员连接数据库, 安装将会创建表, 和创建一个新的用户(数据库连接用户), 管理员的用户名和密码只在安装时使用, 且不会被保存.

不要忘了给系统管理员的密码设置一个密码(最下面两个文本框)

输入完选项后, 点击 "下一步", 进入信息确认页面, 如下图所示:

如果选择的是 hsqldb 数据库, 只显示可以设置的项

对上一步输入的信息进行确认后, 点击 "开始安装"

安装成功

安装成功后, 出现安装成功页面, 根据提示转到后台进行设置或转到首页

安装成功后, 您应该先以管理员身份登陆, 并且进入到后台进行一些必要的设置, 如增加顶级版面和二级版面.

默认的系统管理员密码为 itcast

2.后台管理

后台管理的首页显示本系统的一些统计信息

版面管理

分为两级, 顶级版面(分类) 和 二级版面(版面), 二级版面不能单独存在, 它一定属于一个顶级版面. 在顶级版面下不能发贴

可执行的操作:

  1. 新增分类/版面
  2. 编辑分类/版面
  3. 删除分类/版面
  4. 上移分类/版面
  5. 下移分类/版面
  6. 对分类/版面进行权限设置

新增分类

点击按钮 "新增分类", 需要输入分类名称.

新增的分类的显示在最下面, 可以使用 "上移" 和 "下移" 调整到合适的位置

默认会为所有的组增加对此新增分类的 "分类访问" 权限, 即所有的组都可以访问这个新增分类 更多的权限控制, 请点击分类后面的 权限设置 进行调整.

编辑分类

可以更改分类的名称

删除分类

只能删除不包含二级版面的空分类, 如果包含, 请先删除此分类下所有的二级版面.

所有组的对这个分类的权限也都将删除.

(分类或版面)上移 / 下移

更改显示顺序, 点击相应的链接即可看到效果

如果已经在最上面, 点击 "上移" 将不会做任何改变; 如果已经在最下面, 点击 "下移" 将不会做任何改变

(分类) 权限设置

选择允许访问这个分类(顶级版面) 的组;
或是选择 "全部允许", 表示任何组都可以访问
或是选择 "全部禁止", 表示任何组都不可以访问

没有权限的用户, 在主页上不会看到这个分类

新增(二级)版面

点击按钮 "在当前分类新增版面".

需要输入版面的名称和描述信息(此版面的介绍)

默认会为所有组增加下列权限:

更多的权限控制, 请点击分类后面的 权限设置 进行调整.

编辑(二级)版面

可以更改(二级)版面的名称和描述信息

删除(二级)版面

将会删除这个版面下的所有文章(主题和回复), 请慎用

在删除之前有提示, 如下图:

上移 / 下移

请参见前面的 (分类或版面)上移 / 下移

(二级版面)权限设置

可以设置下列权限

注: 如果没有特殊说明, 操作方法如下
选择可以对当前版面做此操作的组
或是选择 "全部允许", 表示任何组都可以对当前版面做此项操作
或是选择 "全部禁止", 表示任何组都不可以对当前版面做此项操作
  1. 访问版面
    是否可以看到并表访问这个版面
    没有权限的用户, 在主页上不会看到这个版面(隐藏的)
  2. 发表回复
    是否可以这个版面中发表文章(仅限回复)
  3. 发表主题
    是否可以这个版面中发起主题.
    注: 前提是需要有 "发表回复" 的权限. 如果只有 "发表主题", 却没有 "发表回复" 的权限, 这个组的用户同样不能在这个版面中发起主题
  4. 允许使用附件
    在这个版面发表的文章(主帖或回复)是否可以带有附件
  5. 允许下载附件
    是否可以下载这个版面中的文章所带的附件
  6. 管理此版面
    相当于这个组就是这个版面的 '版主', 在 组的权限设置 设置中可以设置组可以做哪些具体的管理操作

组管理

每个用户都必须属于至少一个组, 用户的权限就是这个用户所属的组的权限的合集.
匿名用户 'anonymous' 属于组 'anonymous'
系统管理员 'admin' 属于组 'administration'
新注册用户属于组 'general'

新增组

点击 "添加组" 按钮, 需要输入组名称和组的描述信息

编辑组

可以更改指定组的名称的描述

删除组

只能删除不包含用户的组, 否则不会执行任何操作, 并且有如下提示:

如果包含用户, 则应先把用户转到其它组再对此组进行删除操作

同时也将删除跟这个组有关的所有权限

(组)权限设置

可以设置以下权限

  1. 是否为超级管理员, 选择 '是' 或 '否'
    超级管理员可以进入到后台进行管理
  2. 允许访问的顶级版面
    选择可以访问的顶级版面(分类)
    不能访问的顶级版面, 对这个组中的用户不可见
  3. 允许访问的二级版面
    选择可以访问的二级版面
    不能访问的二级版面, 对这个组中的用户不可见
    前提是可以访问这个版面所属的分类
  4. 允许回复
    选择可以在哪些版面中发表文章(仅限回复)
    可以回复或者进行投票
  5. 发表主题
    选择可以在哪些版面中发起主题
    注: 前提是需要有 "发表回复" 的权限. 如果只有 "发表主题", 却没有 "发表回复" 的权限, 这个组的用户同样不能在这些版面中发起主题
  6. 设置主题置顶, 公告等, 选择 '是' 或 '否'
    是否允许发表 '置顶' 或 '公告' 类型的主题
    依赖于权限 '发表主题'
  7. 发起投票, 选择 '是' 或 '否'
    是否可以在发表的主帖中带有一个投票
    依赖于权限 '发表主题'
  8. 附件相关 --> 是否允许使用附件
    在哪些版面中发表的文章(主帖或回复)可以带有附件
  9. 附件相关 --> 允许下载附件
    可以下载哪些版面中文章所带的附件
  10. 管理的版面
    可以管理哪些版面, 相当于 '版主', 需要下面几个权限配合
  11. 删除帖子
    是否可以在管理的版面中删除文章(回复或主帖)
  12. 修改帖子
    是否可以在管理的版面中修改文章(回复或主帖)的内容
  13. 移动帖子
    是否可以在管理的版面中移到整个主题(包含主题的所有回复)到另一个版面
  14. 锁定和解锁主题
    是否可以对主题进行 '锁定' 或 '解锁' 的操作
    被锁定的了的主题不能进行回复

会员管理

admin 用户拥有所有权限, 不管他在哪个组

可执行的操作

  1. 显示所有注册用户
  2. 按组显示
  3. 按用户名查找
  4. 修改会员所属的组
  5. 编辑会员的个人资料
  6. 锁定/解锁 会员

显示所有用户

默认就是分页的显示所有会员, 分页显示, 每一页的大小可以在 系统设置 中进行设置

按组显示

显示属于某个组的所有的会员, 分页显示

按用户名查找

显示名字中包含某字符串的所有用户, 分页显示
如果不输入任何字符, 点击 "搜索" 按钮, 则显示所有用户, 分页显示

修改会员所属的组

一个会员可以同时属于多个组, 这个会员的权限就是他所属的组的权限的合集
会员至少要属于一个组

编辑会员的个人资料

修改会员的个人资料, 可以修改会员名, 不强制输入电子邮件地址, 可以直接设置新密码(不需要输入旧密码)

锁定/解锁 会员

在会员信息那一行的后面有链接 '单击锁定' (如果会员当前是未锁定状态), 可以锁定当前会员;
或是 '单击解锁' (如果会员当前是锁定状态), 可以解除当前对当前会员的锁定
或是选中想要操作的会员(选区中编辑链接后面的选择框), 然后点击按钮 "锁定/解锁选定的会员", 对一批会员进行操作

被锁定的会员不能登陆, 直至管理员给其解锁
对某个会员进行锁定操作时, 如果这个会员已是登陆状态, 则此会员将被强制登出

搜索管理

  1. 显示当前索引信息(数据库中的文章总数和索引文章的总数)
  2. 查询某个文章是否被索引(查询ID)
  3. 重新创建索引

如下图:

重新创建索引

  1. 按日期
    指定一个时间范围, 发表时间在 开始时间(某年某月某日0时0分0秒) 至 结束时间(某年某月某日23时59分59秒) 的文章都将重新被索引(索引方式请参见下面的选项)
  2. 按文章的ID
    id 在 开始id(包含) 至 结束id(包含) 的帖子都将重新被索引(索引方式请参见下面的选项)
  3. (重建索引)选项
    加入索引前检查文章是否存在, 如果文章已经被索引过, 则跳过这篇文章, 可以避免数据重复
    创建/更新索引, 如果文章的索引已存在, 则删掉后重建, 如果选择了此项, 则上面那一项就不再起作用
    将纪录加到现存的索引数据库而不重新建立, 默认选项
    建立一个全新的索引数据库, 这样将会删除所有存在的索引纪录(请慎用), 操作成功后, 索引数据库中只存在本次建立的索引

系统设置

基本设置

头像

附件设置

配置文件管理

显示本系统所用的两个配置文件, 如果直接修改了配置文件, 可以点击 '重新加载所有配置文件' 使更改生效

除非您知道如何修改, 建议不要直接修改配置文件, 修改不当有可能造成系统无法使用

3.版主管理

在主题列表页面中进行管理

正常登陆, 如果这个会员是某个(二级)版面的版主, 则在浏览这个版面时, 会有如下显示

可以点击主题标题前面的选择框选择一个主题, 选完主题后, 点击页面下方的管理按钮进行管理, 可进行以下操作:

  1. 删除     删除选中主题, 这个主题下的所有回复都将被删除
  2. 移动     移动选中主题(包含所有回复) 到另一个版面
  3. 锁定     锁定选中主题, 锁定的主题将不能进行回复.   如果主题目前就是锁定状态, 则不会做任何操作(但会生成操作日志)
  4. 解锁     解锁选中的主题.   如果主题目前就是正常(未锁定)状态, 则不会做任何操作(但会生成操作日志)

点相应按钮后, 显示如下页面 (以 '移动' 举例, 其它类似)

在上半部分是选中的主题的列表, 在这里 可以再次进行选择, 未选择的将不会做任何操作
输入操作原因, 操作原因将会作为日志保存.

在主题显示页面中进行管理

在主题显示页面中可以对这个主题进行管理, 在主题显示页面的最下面有3个管理按钮(红色圆圈处)

点击进入管理页面, 以后操作和上面所述一致.

还是在主题显示页面中, 可以点击文章标题右边的 '编辑' 对文章进行编缉, 或点击叉号删除这个回复

以上操作均需要相应的权限

4.普通用户使用功能介绍

发表文章

编辑器使用的是 fckeditor. 如下图, 点击 "全部功能" 显示全部按钮, "全部功能" 链接变成 "简单功能", 再次点击, 回到原来状态

插入图片

点击 [插入图片]

  1. 添加网上图片
  2. 添中本机图片

添加后都会在预览处显示图片, 可以使用左侧设置具体属性. 如果添加了本机图片后没有在预览处显示图像, 请按照下方提示操作

插入表情图片

点击 [插入表情]

这些图片使用的是 淘宝旺旺 的表情图片, 点击对应图片即可插入

可以带有附件

点新增附件可以增加附件, 每个附件可以带有一段文字说明
最多可增加 n 个附件, 每个附件应小于 s KB (n, s 可以在 系统设置 中进行设置)

如果发表的是一个主题

  1. 如果您有发表公告或置顶主题的权限, 您可以内容下方选择主题类型
  2. 如果您有发起一个投票的权限, 就可以为这个主题附带一个投票
    投票中至少要有两个可选的投票项目
    可以设置投票期限(单位: 天), 过期就不可对此投票帖进行投票, 0代表没有期限

搜索

点击页面最上方 '搜索' 链接, 可以进入搜索页面

可以按以下两种方式搜索

  1. 帖子
    将在帖子的标题的内容中搜索, 搜索结果按其匹配度排列, 匹配度高的排在前面
  2. 作者
    要求输入的是 作者的全名, 例如搜索 "ab" (不包含引号), 结果中不会有会员 "abc" 发的帖

搜索选项: 可以限定在哪些版面中进行搜索

也可以在浏览某个(二级)版面时, 使用主题列表上方的简易搜索功能在当前版面中对帖子进行搜索

个人资料

用户登陆后, 可以点击 "个人资料" 链接修改个人资料.

注: 不可以修改会员名, 必须输入电子邮件地址, 需要修改密码时才输入新密码和旧密码

在最下面可以上传一个图片做为头像
做为头像的图片文件有大小限制, 和图片显示的像素大小限制
如果超过了限制的文件大小, 则不会上传成功, 如果文件大小合格, 但显示的像素大小超出限制, 则系统在保存时会等比例的压缩此图片至合适大小.

如果已经在使用一个头像, 可以勾选头像预览下面的删除, 删除目前使用的头像
或点击 "浏览", 更换一个头像(更换头像后, 原来所使用的头像将被覆盖, 且不可找回).

登陆

自动登陆

点击页面上方 "登陆" 链接进入登陆页面, 可以勾选 "d 天内自动登陆" (d 为后台设置自动登陆有效时间), 在 d 天内自动登陆. 直至过期或用户登出
提示: 自动登陆使用了 cookie, 所以如果您清除了 cookie, 自动登陆也将失效.

如果正在浏览(站内)某个页面, 点击 "登陆" 链接成功登陆后将回到登陆前正在查看的页面.

限制登陆次数

如果连续 t 次登陆失败(密码不正确), 则此用户在 m 分钟内不能进行登陆(被锁定). t 和 m 可以在 系统设置 中设置

5.获得协助或支持

出现异常

出现异常后会显示如下页面

点击 "发送错误报告" 链接给我们发送此异常的信息, 我们收到报告后会及时的检查和修复. 或者点击编辑邮件, 给我们发送邮件, 我们会及时答复

联系我们

最新信息, 请访问 http://www.itcast.cn. 有什么问题或建议, 请发邮件到: tyg@itcast.cn