bttlxeForum - 高级 ASP 论坛软件

• 下载软件 - 1.19 Mb
• 在此处查看实时论坛（站外）

目录

• 引言
  • 概述
  • 考虑因素
  • 特点
• 安装
  • 离线
  • 在线
  • 高级说明
• 用法
  • 终端用户演练
  • 管理员演练
• 开发
  • 组织
  • 查看位置
• 已知问题
• 许可证
• 致谢
• 历史

引言

bttlxeForum 2.0 是一款免费软件，用于为网络用户提供广泛的在线论坛。该软件可以轻松配置，以适应从产品支持网站到繁荣的网络社区等各种用途，并且设计方式允许即使在大量自定义的情况下也能使用其功能。

bttlxeForum 的最新版本可在 http://forums.bttlxe.com/ 上查看。

概述

本文档不仅试图展示如何为您运行 bttlxeForum，还解释了该软件的工作原理以及如何对其进行开发。希望读者在阅读后能够有信心深入研究源代码并开始使用该软件，而不仅仅是使用它。

该软件使用 Active Server Pages 和 JScript 编写，因此目标平台是 Microsoft Windows 服务器。在 ASP 模拟器的帮助下，有可能在其他平台上成功使用它，但此类使用不受支持。bttlxeForum 广泛使用 CSS1 和模块化页面组件，以便经验丰富的 Web 开发人员可以轻松直观地完全自定义论坛的外观。

注意事项

不假定读者熟悉 bttlxeForum，但读者应熟悉 Internet 软件和网站的工作方式，以及一般的 Web 开发术语和技术。理解在线论坛软件将是一个优势，但不是必需的。

不建议您升级 bttlxeForum 的先前版本到 2.0。未来的升级将由软件处理。

功能

bttlxeForum 2.0 具有许多独特的功能，并且比以前的版本有许多增强功能。

左键单击 gadget 并拖动以移动它。左键单击 gadget 的右下角并拖动以调整其大小。右键单击 gadget 以访问其属性。

• 基于软件的安装程序，可以下载最新版本并配置脚本以上传到您的 Web 服务器。
• 支持多语言安装
• 只需单击一下即可应用模板/主题，从而完全定义论坛的视觉外观。可以轻松创建自定义模板，将论坛集成到您现有的网站设计中。
• 已确认在最新版本的 Internet Explorer、Mozilla、Mozilla Firebird 项目和 Opera 中完美运行（动态视图在除 Internet Explorer 4.0 或更高版本之外的所有版本中都表现为普通视图）。
• 目前可以使用 SQL Server 2000 或 Microsoft Access 存储其数据。
• 无限数量的成员、论坛、组和消息。
• 提供完整的经典 ASP/Jscript 源代码。
  

论坛

• 活动用户列表，显示当前在论坛中的用户。
• 用户可定义的论坛视图，从更传统的线程视图到这里 CodeProject 使用的基于树的视图。
• 可以在新帖子中插入投票。
• 可以设置为私有（仅对特定组的成员可见/可访问）。
• 可折叠的论坛类别。
• 作者可以选择在收到回复时通过电子邮件收到通知。
• 可以使用论坛代码（类似于安全限制的 HTML 标记）来增强消息。
• 使用受支持的 Internet 浏览器发布消息时，会显示用于表情符号和常用论坛代码的工具栏。
• 可以按论坛、用户或类别搜索关键字。
• 允许授权成员进行版主管理。
• 防止消息泛滥。
• 版主可以删除或锁定整个帖子或单个消息。
• 不良词语审查器。
  

组

• 组版主可以添加和删除组成员。
• 可以授予从论坛管理到限制论坛访问（可用于隐藏论坛不让非成员看到）的权限。
• 可以是公开的或私有的（私有组的成员不可见）。
• 可以轻松地将私信发送给所有组员。

用户

• 可以是成员、版主或管理员用户帐户类型（分别授予论坛范围的权限）。
• 用户之间可以发送私信。
• 可以在公开个人资料中包含即时通讯详细信息。
• 可以在公开个人资料中包含照片、传记和网站链接。
• 可以定义一个显示名称作为其公开名称，而不是其帐户名称。
• 可以定义一个自定义签名，用于其消息。
• 可以选择不与成员共享电子邮件地址（这是默认设置）。
• 必须激活其帐户才能使用该帐户来验证电子邮件地址。
  

Administration

• 如果存在，则可以配置。
• 可以查看、更新和删除用户。
• 可以创建、更新和删除论坛；可以定义类别。
• 可以创建、更新和删除组；可以分配组版主。
• 可以将成员添加到组，并将组授予论坛权限。
• 可以设置论坛范围的设置，例如安装名称、设置、邮件服务器、默认论坛视图等。
• 可以清除数据库中的旧成员帐户，无论是自去年以来未使用过的，还是创建但未在 last week 内激活的。
• 自动论坛更新 - 一键即可检查是否有可用更新，并立即下载。
  

与先前版本相比的其他更改。

• 修改了所有日期戳，以使用通用日期/时间格式，该格式将在所有区域设置中都可用。
• 验证保护，防止常见的 SQL 注入攻击。
  

要求

• Microsoft Windows 2000/ Windows XP Professional/Windows Server 2003（不支持 Windows XP Home）。
• Microsoft IIS v5.0 或更高版本。
• Microsoft SQL Server v2000（或 MSDE 2000）数据库或 Microsoft Access 95 或更高版本数据库（计划支持其他数据库类型，并且可以支持）。
• 大约 3MB 硬盘空间用于 Web 文件（源代码和图像文件）。
  

安装

本文档随附 bttlxeForum 2.0 的发布版本，以方便的 zip 压缩包形式提供。下载后，将 zip 压缩包的内容解压缩到一个临时目录。现在需要安装该软件，通过运行 bttlxeForum.exe 安装程序来为您的目标环境正确设置。按照安装程序的指导完成剩余的安装步骤。

 

 

（对于以下部分，“离线”表示安装在本地开发计算机或内部网络上，“在线”表示安装在实时 Web 服务器上。）

离线

在安装过程中，您将指定您的本地开发计算机或服务器名称以及脚本将在该计算机上安装的位置。您应该找到已配置的 bttlxeForum 安装，并将其复制到目标计算机上的正确位置。

如果您以前没有这样做过，例如，如果论坛未添加到现有的网站，请在目标计算机上使用 Internet Information Services 创建一个网站或虚拟目录来公开安装。

通过 Web 浏览器访问目标目录并运行 onetimesetup.asp 脚本以完成安装。如果您的访问权限允许，该脚本将在执行后自动删除，否则您必须手动删除它。

如果您正确完成了此过程，软件应该能够检测到它是离线访问的，并确保所有相关的链接和数据库连接都对安装是正确的。

在线

同样，在安装过程中，您将指定您的实时 Web 服务器名称以及脚本将在该计算机上安装的位置。您应该找到已配置的 bttlxeForum 安装，并将其复制或上传到目标计算机上的正确位置。

（注意：如果通过 FTP 上传，请确保所有图像文件和/或数据库文件都作为二进制文件上传。如果您的安装选择要求这样做，您的安装可能附带一个 ReadMe.txt 文件，其中将解释需要特殊访问权限或位置的任何目录。）

通过 Web 浏览器访问目标目录并运行 onetimesetup.asp 脚本以完成安装。如果您的访问权限允许，该脚本将在执行后自动删除，否则您必须手动删除它。

如果您正确完成了此过程，软件应该能够检测到它是在线访问的，并确保所有相关的链接和数据库连接都对安装是正确的。

高级说明

如果您希望为离线和在线安装使用相同的数据库，或者希望在运行 onetimesetup.asp 脚本之前更改配置，您可以编辑目标目录中 createdatabase.asp 文件中的数据库连接字符串和相关详细信息。请注意，对连接字符串的更改需要复制到 /include/config 目录中相应命名的文件中。

用法

本节将提供典型的终端用户和管理员的基本演练。

终端用户演练

论坛软件的主页显示了当前用户（匿名登录或使用成员帐户登录）可以看到的可用论坛列表，这些论坛按类别组织。用户选择一个论坛来查看其消息。

查看论坛时，显示给用户的消息、格式和操作将由他们当前的“视图”设置决定，这些设置可以随时从消息列表顶部看到和更改。用户可以通过在搜索框中输入搜索词来搜索该论坛的关键字，或使用单独的“搜索”页面使用更高级的标准搜索论坛。

如果允许，可以创建新消息和回复，并向用户显示格式选项以帮助他们格式化消息。

用户可以向其他成员发送私信，这些私信将发送到他们在软件中的虚拟邮箱。

用户的公开个人资料包含他们明确选择向其他用户公开的个人信息，例如姓名和电子邮件地址。

管理员演练

论坛管理页面在登录管理员帐户时可用，并提供对软件所有重要区域的便捷访问。

bttlxeForum 配置

查看和修改全局 bttlxeForum 设置，例如站点名称、电子邮件服务器、默认用户设置以及站点是处于活动状态还是因维护而禁用。

模板配置

更改正在使用的模板/主题。已安装的模板将显示为列表供您选择。

成员

查看已注册论坛成员的摘要或详细视图，包括更新其信息的链接。

论坛

添加、删除或修改论坛及其类别，并管理组对特定论坛的访问和权限。

组

添加、删除或修改组，并管理组成员。

清理成员帐户

这允许您从数据库中删除从未激活其帐户的用户，或那些在过去一年中未使用过其帐户的用户。

帮助和提示

查看有关管理 bttlxeForum 软件的有用信息和提示。目前，此页面链接到本文档和在线支持论坛。

更新脚本

bttlxeForum 2.0 包含一种新的软件更新方法，当新版本发布时，会自动升级软件和您的数据库。这些页面将详细介绍并指导您完成任何可用更新。

开发

本节概述了论坛软件的结构以及各种操作的执行位置。

组织结构

脚本根据其任务分为六个部分，这反映在目录结构中。

• Admin - 所有管理任务都在此部分；从管理论坛到设置组权限以及检查软件更新。
• Forum - 前端查看和用于向论坛添加消息的表单。执行诸如获取和显示消息等任务的代码在 Utils 部分。
• Include - 包含在其他部分的文件，例如数据库配置和路径信息。
• MyAccount - 所有与用户帐户和用户任务相关的脚本都在此部分，例如个人资料、私信和帐户维护。
• Templates - 包含每个已安装主题的子目录。Templates 目录包含有关使用主题和模板的进一步说明。
• Utils - 本节分为更多子目录，包含软件的大部分实际代码。
  

查看位置

使用上面的组织信息，应该可以轻松找到实现或应添加特定功能的章节。每个部分中的脚本命名都与其用途具有描述性，例如，用于插入新论坛消息的脚本将命名为 new.asp 并位于 Forums 部分。

考虑以下示例：

• 如果您想添加一个用户可以在其公开个人资料中包含的新字段，您应该在 MyAccount 部分查找个人资料脚本。
• 如果您想修改论坛的常见问题解答，您应该在 Forum 部分查找 FAQ 脚本。
• 如果您想安装新模板或修改现有模板，您应该在 Templates 部分查找。
• 如果您想定义一个新的“视图”来显示论坛中的消息，您应该在 Utils 部分的“views”目录中查找。
  

已知问题

• 高级搜索结果首先按主题和论坛排序，然后按日期排序。
• 某些安装需要进行调整才能工作，特别是如果您使用非标准 Web 服务器配置或远程数据库。
  

许可

bttlxeForum 2.0 是许可软件。您在安装软件时必须同意完整许可，但为方便参考，此处显示了摘要版本。

允许您免费使用或持有该软件以用于任何目的，包括学习和修改，但不得以成本价转让给第三方或声称拥有所有权。

如果您对软件进行了修改并希望以源代码形式将其发布给第三方，则必须获得许可。使用软件还有其他一些条件和限制，这些内容已在完整许可的开头部分进行了说明。

致谢

我想感谢

• bttlxeForum 的 beta 测试人员，他们帮助查找、修复和防止 bug 进入此版本，并提供了许多功能建议，以及他们对完成 beta 测试的耐心。
• Jason Jystad，为用于输入消息的许多动态输入控件提供了脚本。
• Chris Maunder 和 Uwe Keim，感谢他们提供的一些基础代码和想法。
• James Shaw，感谢他提供了我在网上找到的最佳 ASP 资源之一 www.coveryourasp.com，以及为软件的某些功能提供了代码。
• 所有等待此版本一年多的人！
  

最后，我想感谢 CodeProject.com 的所有者继续为开发人员提供如此出色的免费资源。

历史

2004 年 6 月 12 日 - 本文第三次发布，以配合软件 2.0 版本的发布。完全重写 - 更改太多，无法一一列出！

2002 年 9 月 18 日 - 第二次发布。脚本进行了许多增强，包括：

• 错误修复 - 除上述问题外，所有已报告的错误在此版本中均已解决。我想是这样……
• 管理脚本 - 您现在可以通过 Web 管理成员系统和论坛。
• 用户界面增强 - 用户界面已重写，更加直观。
• 匿名用户 - 您可以选择允许在任何论坛中匿名发帖。
• 论坛访问权限 - 您可以限制在任何论坛中创建新主题或回复。
• 主题控制 - 您（管理员）可以删除整个主题或特定帖子，或者锁定它们以防止进一步回复。
• 新消息跟踪 - 自上次访问以来发布的消息将标记为新。
• 安全增强 - 您不再能在各种字段中输入 HTML、脚本、SQL 等，以防止可能的客户端脚本或 SQL 注入攻击。
• 关键字搜索 - 您可以通过指定关键字（可以包括通配符）来过滤任何论坛，并且只会显示匹配的消息（并且关键字会被高亮显示！）。

2002 年 2 月 14 日 - 初始发布。