Project Goldenfaith 帮助文档

欢迎使用Project Goldenfaith，这篇文档将帮助你顺利完成安装和配置工作。

一安装前

准备一个Apache+MySQL+PHP空间。基本要求：支持URL重写（Rewrite）；PHP版本5.1以上。
打开upload目录内的config.php文件，修改以下两段代码。

* 不支持IIS主机

* 修改请用专业的文本编辑器，如editplus，nodepad++等，不可以用win的记事本。修改完毕保存成UTF-8, NO-BOM格式。

// ======= 站点URL设置 ==========

// 域名 如 www.goldenfaith.org
define('GF_DOMAIN', '127.0.0.1');

// 安装目录 放在根目录就是 define('GF_DIR', '/') ；放在子目录下前后2个"/"都不可以省略。
define('GF_DIR', '/goldenfaith/');

// URL 这个不用改
define('GF_URL', 'http://' . GF_DOMAIN . GF_DIR);

// ======= 数据库设置 ==========

// 数据库类型 可选 mysql 或者 mysqli
define('GF_DB_TYPE', 'mysql');

// 主机地址
define('GF_DB_HOST', 'localhost');

// 用户名 
define('GF_DB_USERNAME', 'your-username');

// 密码 
define('GF_DB_PASSWORD', 'your-password');

// 数据库名称 
define('GF_DB_DBNAME', 'your-dbname');

// 表前缀 推荐 foo_ 这种形式
define('GF_TABLE_PREFIX', 'gf_');

二安装

上传upload目录内的文件到服务器上（不包括upload目录本身）。
在浏览器里运行install.php。页面顶部会出现"添加频道和讨论区"的链接，这样表示安装成功了。

三添加频道和讨论区

添加完毕按一下更新讨论区数量和更新缓存。
删掉根目录下 install.php 和 manage.php 两个文件！

* 频道和讨论区相当于一般论坛程序的分类和版块。

* 讨论区的描述(description字段)是支持HTML代码的。

四 config.php详解

config.php是整个程序的核心文件，所有配置都在此。

* 以下没有详细说明的或者你不能理解的define用默认的就行了。

// ======= COOKIE设置 ==========

// 名称 任意 比如 yoursitename_cookie
define('GF_COOKIE_NAME', 'gf_cookie');

// 有效期（秒） 默认值 一年
define('GF_COOKIE_EXPIRY', 31536000);

// 作用路径
define('GF_COOKIE_PATH', '/');

// 作用域
define('GF_COOKIE_DOMAIN', '');

// HTTPS
define('GF_COOKIE_SECURE', 0);

// 加密辅助字符串
define('GF_COOKIE_SEED', '54df2e86f59e1df7');

// ======= 站点配置 ==========

// 站点名称（长）
define('GF_SITENAME_LONG', 'Goldenfaith');

// 站点名称（缩写） 可以和上面一样。
define('GF_SITENAME', 'GF');

// 站点描述 在remix首页可以看到这条内容。"remix首页"链接在下拉菜单里。
define('GF_DESCRIPTION', 'Welcome to Goldenfaith official website');

// 关键词 
define('GF_KEYWORDS', 'goldenfaith');

// 页面底部内容 也包括登录页面、短消息页面和手持设备访问页面的底部。
define('GF_COPYRIGHT', '© 2008-2010 Goldenfaith.org');

// 管理员ID ID可以在会员主页查看。
// 管理员有编辑、移动、删除主题和回复的权限。
// 可以指定多位管理员，如 define('GF_ADMINS', '1,2,3') 数字之间用逗号隔开。
define('GF_ADMINS', '1');

// 安装路径 这个不用改
define('GF_ROOT', dirname(__FILE__) . '/');

// 调试模式 程序运行有错误会显示出来 建议开着。true开 false关 也可以用1和0代替，以下同。
define('GF_DEBUG', true);

// 显示查询语句 上面的调试模式开着才会显示
define('GF_QUERIES', false);

// 页面压缩 这个不用改
define('GF_GZIP', true);

// 离线时间（秒）
define('GF_TIMEOUT', 300);

// 主题和回复编辑时限（秒） 过了这个时间就不能再编辑了，这个只对会员而言，管理员没有这个限制，下同。
define('GF_EDIT', 86400);

// 主题和回复删除时限（秒）
define('GF_DELETE', 3600);

// 会员据点上限 会员页面能添加的网址数量。
define('GF_SAVEPOINT_LIMIT', 10);

// ======= 显示调节 ==========

// 新帖（秒） 1天（默认）之内创建的主题  标题前面会有一个new图标
define('GF_NEW', 86400);

// 热门主题（回贴数） 见下面
define('GF_HOT', 10);

// 首页单个热门主题展示（秒） 在首页导航栏下面出现。
// 满足2个要求：一 是热门主题； 二 最后回复时间距现在不超过一个月（默认）
define('GF_SINGLE', 30 * 86400);

// 首页最新讨论主题数量 "Latest Discussions"下面的主题数量。
define('GF_RECENT', 15);

// 首页头像展示（秒） 一个月（默认）之内登录过的用户才会展示
define('GF_AVATAR', 30 * 86400);

// 随机彩色显示（主题回复数和讨论区主题数） 大于这个值的显示彩色，小于这个值的显示灰色。
define('GF_COLOR', 5);

// 每页显示主题的数量
define('GF_TOPICS_PAGE', 20);

// 每页显示回复的数量
define('GF_POSTS_PAGE', 10);

// 每页显示主题的数量（mobile）
define('GF_TOPICS_PAGE_M', 10);

// 每页显示回复的数量（mobile）
define('GF_POSTS_PAGE_M', 10);

// 每页显示用户的数量
define('GF_USERS_PAGE', 30);

// 每页显示消费记录的数量
define('GF_EXPENSE_PAGE', 20);

// 每页显示ING的数量
define('GF_INGS_PAGE', 10);

// ======= 会员花费 ==========

// 注册 注册能得到的铜币数量，默认2010
define('GF_EXP_SIGNUP', intval(date(o)));

// 主题创建 
define('GF_EXP_TOPIC_CREATE', -20);

// 主题修改
define('GF_EXP_TOPIC_EDIT', -5);

// 回复别人的主题 主题的创建者得到的铜币是这个值的绝对值，即abs(GF_EXP_REPLY)
define('GF_EXP_REPLY', -5);

// 回复自己的主题
define('GF_EXP_REPLY_SELF', -3);

// 发送短消息
define('GF_EXP_MSG_SEND', -5);

// 页面访问奖励
define('GF_VISITING_AWARDING', true);

// 下面两个全局变量分别是 短缓存 和 长缓存 。
// 其中 caching 和 lifetime 分别表示 开关 和 缓存周期（秒） ，如 caching => false 表示将缓存关掉。
// cacheDir 和 hashedDirectoryLevel 不用改。

$CACHE_LITE_SHORT = array(
										'cacheDir' => GF_ROOT.'cache/', 
										'caching' => true, 
										'lifeTime' => 300, 
										'hashedDirectoryLevel' => 0
									);
$CACHE_LITE_LONG = array(
										'cacheDir' => GF_ROOT.'cache/', 
										'caching' => true, 
										'lifeTime' => 7200, 
										'hashedDirectoryLevel' => 0
									);

// 页面缓存（秒） 导航栏的下拉菜单和sitemap用到了页面缓存。默认周期1天。
define('GF_PAGE_CACHE_TIME', 86400);
// 维修状态
define('GF_MAINTENANCE', false);

五 MISC

修改根目录下的robots.txt，将URL地址改成你的。

Sitemap: http://www.goldenfaith.org/sitemap.xml

频道和讨论区图标分别在 image/channel/ 和 image/node/ 内。ID和图片名称对应，图片必须是gif后缀。如果没有则使用 0.gif 。
template目录下有3个文件没有写：about.html(关于)、guide.html(社区指南)和out_of_money.html(铜币用完之后出现的页面)，请自行补充。

Project Goldenfaith 帮助文档

一 安装前

二 安装

三 添加频道和讨论区

四 config.php详解

五 MISC

2010年6月23日

一安装前

二安装

三添加频道和讨论区