mvnForum管理文档

  mvnForum管理文档
作者：Cord Thomas
翻译：王锐
原文出处：http://www.mvnforum.com/mvnplugin/mvnforum/docs/admin.html
修订历史
Revision v0.4 20 January 2005 cat
升级到RC4的新特性
Revision v0.3 20 April 2004 cat
Updated for new features in RC3.
升级到RC3的新特性
Revision v0.2 16 Jan 2004 cat
升级到RC2的新特性，重新整理了文档，多了很多论坛结构的描述。
Revision v0.1 8 June 2003 cat
为RC1准备的用于安装和指导用户使用的文档
________________________________________
写在前面的话 2
1 一般性管理 2
1.1 测试系统配置 2
1.2 配置mvnForum 2
1.3 邮件模板 5
1.4 建立搜索索引 5
2 概述 6
3 论坛管理 6
3.1 Category 6
3.2 Forum 7
3.3 指定组到forum 9
3.4 对Forum指定会员 9
4 组 9
4.1 默认组 9
4.2 组管理 9
5 用户 11
5.1 默认用户（略） 11
5.2 用户管理（略） 11
5.3等级管理 11
6 权限 11
6.1 组合权限 11
6.2 单独权限 12

写在前面的话
本管理员手册介绍如何建立您的第一个在线论坛以及如何合理使用论坛管理工具。如果在这里您没有找到要找的东西，请看我们为您精心准备的FAQ部分。
1 一般性管理
一般性的论坛管理任务，诸如测试论坛安装的配置或建立搜索索引，请访问Miscellaneous tasks（杂项任务）页面。
1.1 测试系统配置
要 测试数据库、邮件支持、索引支持和图片处理支持，可以在Miscellaneou页面或管理控制面板页面点击“Test System Configuration”链接。下面的系统参数会被测试，大部分参数都附加一个简短解释，包括每个参数重要性描述和到哪里可以解决这个参数造成的问 题。
? Support JNDI……用来为Java应用服务器定位论坛框架类。如果没有JNDI支持，那么最大的可能性是论坛没有正常安装。
? Java SQL Ext……标准的Java SQL扩展，通过javax.sql.DataSource提供标准连接池。
? Java Activation Framework……用来为JavaMail发送邮件
? Java Mail……Java邮件扩展用于处理SMTP消息，这些消息是管理员使用论坛监视系统发过来的。
? Jakarta BeanUtils……用来为一般的上载avatar图片用
? Jakarta Common Logging……Java通用日志接口是一个用于日志消息的通用接口，用作日志事件和错误的模板。这个接口可扩展以提供可定制的日志方案。
? Jakarta Common Codec……不确定
? Jakarta Common Collection……支持可用的收集操作符
? Jakarta Common Digester……不确定
? Jakarta Common Lang……不确定
? Jakarta Regular Expressions……规则表达式用于支持搜索功能
? Jakarta Lucene……一个完全的内容索引和搜索接口，这个接口支持论坛thread（话题，或者叫主贴）搜索。
? Dom4j……一个用于java的XML文档对象模型解析器
? Image Processing……用于支持avatar图标和captcha图片
1.2 配置mvnForum
mvnForum 的新功能是使用在线配置接口来配置web应用。首先要完成最小安装。把论坛运行起来，并确保您能够访问管理员控制面板，那么您就可以在控制面板中配置剩下 的论坛参数。在installation包中可以找到最小化安装的说明，它会一步步地教您如何使mvnForum运行起来。
从管理控制面板中可以 访问配置菜单，配置菜单有如下主要部分：备份配置文件；核心论坛配置，参数写进mvnforum.xml中；工厂配置（对论坛主要用户授权和http处理 请求的鉴定）；用于全局标准用户接口设置的接口配置；以及核心服务器配置，参数写进mvncore.xml中。
配置信息的改变不会立即生效。事实 上，Servlet容器重启之前，大部分应用程序的参数都不会生效。mvnForum提供了一个重载特性以强迫应用程序重新读入论坛配置。在管理员的配置 菜单中点击“Reload all Changes”链接就可以强制mvnForum重新读入配置信息。读入mvnforum.xml配置文件中的所有参数后mvnForum会重启；即大部 分参数都能立即生效。

下面这个部分定义了单个配置参数的用途：
Backup Configuration File
? 在改变论坛配置之前对两个配置文件做一个备份。在管理员的论坛配置页面上，点击“Backup Configuration File”链接就会执行一次对配置文件的备份。
? 要恢复保存过的版本，必须停止Servlet容器，用配置文件的备份覆盖当前配置文件，重启Servlet容器。
mvnForum Core Configuration
? mvnforum_home[绝对网络路径]……MVNFORUM_HOME是一个可以通过web访问的文件夹，您可以在WEB-INF文件夹下创建一个 mvnForumHome文件夹并设置MVNFORUM_HOME指向这个文件夹。请注意这个例子是用于Windows系统的，对于linux系统，应该 写成这样：MVNFORUM_HOME =/home/tomcat/mvnForumHome
? webmaster_email……[字符串，合法的邮件地址]webmaster的邮件地址
? logo_url……[字符串，一个完全的http url]logo指向的url
? supported_locales……[字符串，任何合法的本地语言] 一个站点支持的本地语言列表，每个语言之间用分号隔开，用于国际化/本地化支持。
? default_locale_name - [String - one of the valid list of supported_locales] - the default locale for the forum
? default_locale_name……[字符串，所支持的合法本地语言列表]论坛默认的本地语言
? default_guest_name……[字符串]设置默认的虚拟Guest用户的名字。重要提示：如果数据库里面存在Guest用户的名字，这个设置会覆盖掉这个数据。
? disable_passwordless_auth……[true/false]这个发布版支持realm/customized授权，如果您想要使用这个特性，请设置DISABLE_PASSWORDLESS_AUTH = false且为非注释
? require_activation……[true/false]论坛会员可以由论坛管理员创建（或发布种子）或通过自己注册来创建。对于个人注册的论 坛会员，您可以要求他们通过邮件激活账号。目前这种方法许多论坛都在用，这样可以阻止bot（自动代理）创建论坛账号。通过邮件激活，在注册过程中就有一 个需要人来进行操作的步骤（虽然有可能人们会增强他们的bot在收集邮件信息和作出相应响应的能力）。
? enable_login_info_in_cookie……[true/false]开启通过浏览器cookies跟踪登陆信息的功能
? enable_login_info_in_session……[true/false]开启通过Servlet session跟踪登陆信息的功能
? enable_login_info_in_realm……[true/false]使用application realm-specific进行授权
? enable_login_info_in_customization……[true/false]
? enable_new_member……[true/false]开启用户自注册功能（即用户自己注册而不是管理员为用户创建账号）
? enable_new_post……[true/false]开启发帖功能，对于整个论坛来说这是默认的功能
? enable_rss[true/false]开启RSS feeds功能。如果为false，就无法提供RSS feeds
? enable_watch……[true/false]开启thread/post监视
? enable_attachment……[true/false]对threads/posts开启附件功能
? enable_avatar…… [true/false]开启会员avatar功能
? enable_emoticon……[true/false]开启用户表情
? enable_moderation……[true/false]开启论坛moderation功能
mvnForum工厂配置
? member_implementation……提供论坛会员管理功能的实现类
? onlineuser_implementation……无说明
? authenticator_implementation……无说明
? requestprocessor_implementation……无说明
mvnForum Interface Configuration
? max_attachment_size……最大附件尺寸
? max_favorite_thread……无说明
? max_edit_days……无说明
? max_attach_days……无说明
? max_delete_days……无说明
? rows_per_page……无说明
? rows_per_rss……无说明
? hot_topic_threshold……无说明
? max_posts_per_hour……无说明
? max_members_per_hour……无说明
? enable_backup_on_server……无说明
? max_import_size……无说明
mvnForum服务器配置
? use_datasource……无说明
? database_type……无说明
? driver_class_name……无说明
? database_url……无说明
? database_user……无说明
? database_password……无说明
? max_connection……无说明
? max_time_to_wait……无说明
? minutes_between_refresh……无说明
? datasource_name……无说明
? blocked_ip……无说明
? mail_server……无说明
? default_mail_from……无说明
? username……无说明
? password……无说明
? port……无说明
? blocked_ip……无说明
? context_path……无说明
? server_path……无说明
? server_hour_offset……无说明
? blocked_user_agent……无说明
1.3 邮件模板
邮件模板用来发送标准邮件给新会员（用于激活账户），响应密码恢复请求，以及为有活动论坛监视权限的用户提供那些他们感兴趣的主题的新帖通知。
使用标准的关键字，您可以从Miscellaneous tasks中的Admin部分访问邮件模板编辑器以创建标准的模板。使用预先定义好的关键字改变3个模板中的一个，这些关键字在模板编辑器的顶部。
改变了一个模板后，通过点击Save Template进行保存。如果从模板列表中选择其它模板不会保存你对当前模板所作的修改。
1.4 建立搜索索引
mvnForum 提供了搜索特性的全集，用户可以通过作者、主题和日期查找帖子。搜索特性是由Jakarta的Lucene项目支持的。Lucene建立了一个由 mvnForum配置的索引，这个索引加快了用户对论坛内容的搜索速度。要重建这个索引，点击Rebuild Searching Index。

2 概述
要启动mvnForum，您应当理解如下基本的几条：
通过论坛管理器启动
? 论坛的层次从上至下分为category、forum、thread（或post）。Thread属于单个forum，forum属于单个category。
? Guest只能对论坛thread进行读和搜索操作
? 对forum的访问是基于组权限和用户权限进行限制的。
? 这里给出一个典型的创建一个新论坛的过程：
o 创建一个新群，叫做newGroup
o 设置为全局组权限（global group permission），那么这样这个组的所有会员都可以登陆和执行其它任务。
o 创建一个新用户，叫做newGroupUser
o 设置newGroupUser为newGroup的拥有者（这个操作也把用户newGroupUser添加为组成员）
o 创建一个新的category，叫做newCategory
o 创建一个新的forum，叫做newForum，newForum放在newCategory下
o 设置newGroup的forum-specific组权限，这样这个组的用户就可以操作newForum
做完这些后，您就有了一个新的forum和一个用户，这个用户属于一个组，这个组可以访问和管理新forum中的所有thread。mvnForum有细粒度的方法来管理forum和组/用户对于forum的权限。

3 论坛管理
mvnForum 采用一种典型的支持组讨论的结构。管理员使用论坛管理控制面板创建、编辑和删除论坛的category和forum。在forum管理控制面板中， forum管理接口显示当前category和forum的列表。使用这里提供的链接就可以管理论坛category和forum。
3.1 Category
论 坛category是forum的顶级群。管理员可以创建category、从category加入和移除forum，以及移除category。同时， 一旦category已经加入到列表中，管理员可以改变category的顺序，在category中加入或移除forum。forum管理请看 Forum部分。
? Add Category……点击页面顶部附近的“Add new Category”链接就会加载category创建页面。一个category有一个名字和一个描述。使用足够简短的描述给论坛用户一个准确的对 forum类型的理解，他们期望在category里看到这些。
? Edit Category……点击列表中与待编辑的category在同一行的( )图标就会进入category编辑页面。在这个页面里可以改变对category的描述或category排序顺序。
? 删除category……由于移除category存在风险，web接口只允许删除空category。要删除category，首先要删除这个category下的所有forum。
3.2 Forum
forum 是一个主题群，共享一个通用的thread或subject。Forum是人们常用的会聚场所，人们在这里互相交流思想、就某个主题提问，对这个主题有兴 趣和知识的人会回答这些问题。要管理您的站点所支持的forum列表，您可以从管理员控制面板进入Forum Management Interface。
? Add Forum……在对应的category行点击“Add Forum”链接，这样您就可以为这个category加入forum。要加入forum，首先要有category。如果您还没有添加category，请访问帮助c。
添加一个新forum
o 论坛Category……一个forum属于一个category。从列表中选择forum所属的category。
o Forum名字……在当前category中必须唯一。目前，名字最长可为250个字符。建议您把名字取得短一些，这样显示效果更好，另外要尽量避免使用有些浏览器不支持的特殊字符。
o 地表达forum主题的话，这个描述为人们提供了关于forum主题的线索。
o Forum排序……此forum在它所属的category下的forum列表中显示的顺序。
o Forum状态……设置forum状态为normal、disabled、locked或者closed。这些状态的意思是：
Forum Status
? Normal……无说明
? Disabled……无说明
? Locked……无说明
? Closed……无说明
o Forum类型……设置forum类型为normal或者private。这些状态的意思是：
Forum Type
? Normal……这个forum对所有注册用户开放
? Private……只对forum版主授权的用户开放。
o Moderation Mode……设置forum的moderation模式为normal或moderated forums列表中的一个。Moderation解释为用户部分的moderation文档。这些类型的意思是：
Moderation Mode
? System Default……默认配置，对整个站点，其值为如下配置的其中一项：
? No Moderation……forum中没有内容是可修改的
? Thread and Post Moderation……thread和post都是可修改的。当修改一个thread的时候，它的post也可修改。
? Only Thread Moderation……只有thread可修改，一旦一个thread提交通过了，自动接收它的所有post。
? Only Post Moderation - only moderate posts, any thread can be started; posts within the thread are moderated
? Only Post Moderation……只有post可修改。
? 编辑Forum……在列表中点击您要编辑的forum那行右侧的“ ”图标即可进入编辑页面。
您可以对forum作的修改：
o 要修改forum所属的category，选择其它的category即可。
o 修改forum名字和描述
o 修改forum的排序顺序。这样可以移动该forum在category的forum列表中的位置。
o 启动一个forum。默认情况下所有新forum都是已启动的，但是您可能想要暂时关闭一个forum。把checkbox上的小钩去掉即可关闭这个forum。
? Group Permissions……最常用的定义forum访问权限的方法就是组权限，组权限定义了会员在forum中的不同动作的授权。要设置一个forum的 组权限，点击这个forum所在行Group Permissions字段下的小图标。这个操作会打开“Assign Group to Forum”表单。查看Assign Group to Forum获取更多信息。
? 会员权限……最granular的定义forum访问权限的方法。典型情况下您会实现组权限，例外的情况是指定group moderator。要授予或回收会员权限，点击对应的forum那一行Member Permissions字段下的小图标。这就打开了“Assign Member to Forum”。查看Assign Member to Forum获取更多信息。
3.3 指定组到forum
这个表单用于对forum指定可访问的组，回顾一下当前组的权限。要指定组权限给一 个forum，从可用组列表中选择一个组并点击“Choose Group”按钮。接下来您就会进入“Edit Forum-Specific Group Permissions”表单，在这里可以添加和移除forum的组权限。这里有combined和individual权限。
3.4 对Forum指定会员
这 个表单用于对forum指定可访问的会员，回顾一下当前会员的权限和当前用户的权限。要对一个forum指定会员权限，在表单中输入会员的名字或会员id （一个唯一的数字关键字），点击“Choose Member”按钮。接下来您会进入“Edit Forum-Specific Member Permissions”表单，在这里可以添加和移除会员的forum权限。也有两种权限……combined和individual。

4 组
对forum的访问是由组权限和用户权限的组合来管理的。一个组是一种角色定义，这个定义提供了访问forum的用户和管理动作的集合。指定用户到组中就为用户提供了访问这些动作的权力。与管理单独的组权限相比，管理组权限并为用户指定一个或多个组的方式更加易于管理。
4.1 默认组
mvnForum安装了5个定义好的组，可以提供如下访问动作。要获得更多关于指定权限定义的信息，请查看Combined Permissions和Individual Permissions。
? Guest……默认所有用户都是guest。Guest可以搜索和读取论坛thread。要获得对forum的更多访问权限，guest必须注册并成为一个member。
? Member……一个member是一个已注册的论坛用户。要成为member，一个guest需要创建一个账号，提供一个合法的邮件地址并激活他们的账号。Member可以创建新的讨论thread并进行编辑。
? Admin……管理员可以管理mvnForum的各个方面，包括管理论坛的category和forum，管理用户账户和组权限。在安装的时候，mvnForum只有一个账号，就是admin，这个账号属于admin权限组。
? Forum Admin……论坛管理者可以管理forum，包括创建新的forum。不能管理组和用户账号或权限。
? Forum Moderator……forum moderator是拥有管理一到多个forum的额外权限的论坛会员。Forum moderation包括管理提交给forum的post。
4.2 组管理
mvnForum 安装的默认组一般情况下对大部分人来说都是足够的，都能提供对论坛区域和动作的访问权力和限制。一些论坛管理者可能想要提供粒度更细的环境，以使得指定组 的人被限制在指定的forum中，forum moderator只能moderate某种forum（只提供moderated forum和unmodetated forum），特定的用户只能在特定的forum中添加或编辑post。
默认的组管理页面显示已存在的组列表、版主、成员数量、编辑组信息的链接和删除组的图标。您不能删除guest或member组，因为这是forum必需的组。在组管理页面中，您点击“Add new group”链接或点击任意一个组名就可以对组进行编辑。
? Add new Group……如果默认的组还不够用，您可以添加您自己的组。您可能想要添加一个这样的组，例如ThisForumModerators，这个组在一个选定forum列表中拥有forum moderator权限。
添加一个新组
o Group name……group name可达到250个字符长度，在整个mvnForum中是唯一的。
o Description……对组的描述，可选。
o Group owner name……forum版主的名字；必须是一个存在的mvnForum会员名。如果您还没有创建并更新拥有这个组的会员的话，可以空着不填。如果您输入的会员名字不正确，那么会员名字就不存在，组拥有者也会空出来。
? Edit Global Group Permissions……每个组都有全局的和指定forum的权限。全局权限应用到这个站点的所有forum。设置全局权限是设置forum权限最通用的方式，因为这个设置适用于所有组、用户和forum。
编辑全局组权限
o Combined Permissions……查看Combined Permissions
o Individual permissions……查看Individual Permissions
? 编辑指定Forum 的组权限……一个组可以授权到单独的forum。要管理一个组的forum访问权力，在组管理控制平台中选中这个组并选择“Edit Forum-Specific Group Permissions”。选择forum并点击“Choose Forum”按钮后就可以添加或从组中移除一个forum。
编辑指定forum的组权限
o Combined Permissions……查看Combined Permissions
o Individual permissions……查看Individual Permissions
? Change Group Option……未实现
? Change Group Owner……要改变一个组的拥有者，点击“Change Group Owner”链接并输入新的组拥有者的名字。这个名字必须是一个合法的存在的论坛账户ID。
? Add Member to Group……要对一个组添加一个新的论坛会员，请点击这个链接，输入新会员的id列表并设置他们的特权。
? List Members in this Group……列出一个组的所有成员，标识出他们是否是这个组的拥有者，他们的组权限如何，以及一个从组中删除每个成员的链接。
? Delete this Group……要删除一个管理组，点击这个按钮。mvnForum在删除组前会要求得到删除确认。注意：删除一个组不会删除它的成员或任意一个该成员所发thread/post。删除一个组可能影响到该组成员的权限，因为该组的权限丢失了。

5 用户
用 户是论坛会员，可能是论坛管理者创建的账号用户，也可能是已注册的论坛访客。用户管理包括添加、移除和编辑用户以及管理用户等级。另外，mvnForum 提供的非常有用的特性是查看用户和他们的权限的功能；发送邮件给所有未激活的成员；以及从论坛数据库中移除好久没有使用的、非激活用户。
5.1 默认用户（略）
5.2 用户管理（略）
5.3等级管理
等级是对论坛用户分类的好方法，用户以他们参与到论坛事务中的程度为基础进行划分。使用等级管理可以设置一个用户必须发表多少帖子才能升到一个新的等级。
默认情况下，mvnForum安装了4个等级，陌生人（少于20个帖子）、新手上路（少于50个帖子）、会员（少于100个帖子）和高级会员（多于100个帖子）。您可以编辑这些选项也可以添加新的等级。
? Edit Rank……修改等级标题或改等级的最少发帖数量
? Add new Rank……输入一个最少发帖数量和等级标题就可以创建一个新的等级

6 权限
在RC2中，mvnForum使用了一种非常常用的权限系统来进行访问授权以及从论坛环境的各个方面对访问进行限制。以限制规则的集合为基础把权限授予到组和用户，对特定功能的单独权限如删除forum和添加post thread。
默 认情况下，新的账号没有授予任何权限，除了那些他们所属的组的权限。用户权限是通过组合用户组权限和用户单独权限来决定的。因此，属于论坛 moderator群的用户有权限moderate那些叫做“thisForum”的论坛，但是没有单独权限去moderate那个论坛
另外，为了组合用户和组权限，mvnForum提供了对整个论坛站点的管理权限，叫做全局权限，对于单个forum，提供了forum权限。
下面部分描述了2类权限，组合权限和单独的权限。
6.1 组合权限
正 如这个名字所暗示的，组合权限是对于更易于管理的category的权限组逻辑集合。下面描述了组合权限以及各个组的单独权限。与您是否在管理group global permissions、group forum permissions、user global permissions或user forum permissions相关，设置权限的结果是不一样的。
? Forum Admin
? Forum Moderator
? Limited User
? Normal User
? Power User
6.2 单独权限
单独权限几乎对用户能够在mvnForum中产生的每个动作都提供访问限制。为了限制用户所能发生的动作，您必须既设置这个用户的权限为空又设置他所属的组权限为空。
? Edit Forum……编辑forum名字、描述和拥有者
? Delete Forum……从category中删除forum
? Read Post……在站点/forum中阅读post/thread
? Add Thread……添加一个thread（第一个post）给任意forum或指定的forum
? Add Post……添加一个post到一个thread，到任意forum或指定forum
? Edit Post……在任意或指定的forum中编辑一个存在的post
? Delete Post……在任意或指定的forum中删除一个post
? Add Poll……发起新的投票
? Edit Poll……编辑一个存在的投票
? Delete Poll……删除一个投票
? Add Attachment……添加一个附件到一个thread/post
? Get Attachment……从一个thread获得一个附件或下载一个附件
mvnForum文档使用docbook创建