Discuz! 论坛如何添加配置选项

Discuz! 论坛在后台有很多配置选项，通过这些配置选项可以实现很多功能。在 Discuz!论坛的二次开发过程中，我们也同样要经常添加一些配置，然后根据配置来进行不同的操作。下面我就来介绍一下如何在 Discuz! 论坛中添加配置选项。

我们以 Discuz!6.0 为例。首先我们来看一下 Discuz! 论坛后台的配置界面，以管理员身份登录论坛后台，依次选择‘基本设置’ -> ‘基本设置’后会出现以下的界面：

图1

这个页面用了框架，我们在右下方的页面中点击右键选择‘属性’，在弹出的窗口中，我们发现这个页面的 URL 是 '/admincp.php?action=settings&do=basic' ,这个页面用的程序是admincp.php ，先来分析一下这个文件。
这个文件的第 172-290 行大致的内容如下：

代码如下：
     $cpscript = '';
    if($adminid == 1) {
        if($action == 'home') {
            $cpscript = 'home';
        } elseif($action == 'runwizard' && isfounder()) {
            $cpscript = 'runwizard';
        } elseif ……
    } elseif($adminid == 2 || $adminid == 3) {
        if($action == 'home') {
            $cpscript = 'home';
        } elseif((($allowedituser || $allowbanuser) && ($action == 'editmember' || $action == 'banmember'))           || ($allowbanip && $action == 'ipban')) {
            $cpscript = 'members';
        } elseif……
    }
    if($cpscript) {
         } elseif……
    }
    if($cpscript) {
        require_once DISCUZ_ROOT.'./admin/'.$cpscript.'.inc.php';
    } ……

这段程序主要就是根据 $action 变量来给 $cpscript 赋值，然后根据 $cpscript 的值来引入 admin 目录下的程序文件。我们注意一下 179 行左侧的 $action 值的判断，会发现其$cpscript 的值是 'settings' ，那就是说 283 行引入的程序文件是 'admin/settings.inc.php' 。
然后打开 settings.inc.php 文件，会发现里面的内容好长呀，不要被这给吓坏了，仔细分析一下就好了。

第 14 行：
代码如下：
$operation = $operation ? $operation : (!empty($do) ? $do : '');
这里会根据 GET 过来的 $do 值来给 $operation 赋值，这个例子中其值是 'basic' 。
第 17 行：
代码如下：
$query = $db->query("SELECT * FROM {$tablepre}settings");
while($setting = $db->fetch_array($query)) {
    $settings[$setting['variable']] = $setting['value'];
}
这些程序段是从数据库把数据读出来存到数组 $settings 中以便下面调用。
下面的程序结构如下：
代码如下：
if(!submitcheck('settingsubmit')) {
    if($operation == 'access') {
    ……
} elseif($operation == 'styles') {
    ……
} elseif ……
} else {
    //表单提交后的数据处理
    ……
}

程序中的 submitcheck 函数是用检查一个表单是否进行提交，如果表单没有提交，则根据前面处理过的 $operation 来显示表单。在这里 $operation 的值是 basic ，其执行的是下面一段：

代码如下：
$operation = 'basic';
showtype('settings_general', 'top');
showsetting('settings_bbname', 'settingsnew[bbname]', $settings['bbname'], 'text');
showsetting('settings_sitename', 'settingsnew[sitename]', $settings['sitename'], 'text');
showsetting('settings_siteurl', 'settingsnew[siteurl]', $settings['siteurl'], 'text');
showsetting('settings_index_name', 'settingsnew[indexname]', $settings['indexname'], 'text');
showsetting('settings_icp', 'settingsnew[icp]', $settings['icp'], 'text');
showsetting('settings_boardlicensed', 'settingsnew[boardlicensed]', $settings['boardlicensed'], 'radio');
showsetting('settings_bbclosed', 'settingsnew[bbclosed]', $settings['bbclosed'], 'radio');
showsetting('settings_closedreason', 'settingsnew[closedreason]', $settings['closedreason'], 'textarea');

在这里用到了一个自定义函数 showsetting ，它的第一个参数是这个配置选项的名字，第二个参数是在 HTML 显示时 input 的 name 值，第三个参数是当前配置选项的值，是上面从数据库查出来的数组 $settings 中的一个值,第四个参数是 input 的类型。我们添加一个自己的配置选项 mytest 。在上面代码的最后面添加如下代码：

代码如下：
showsetting('settings_mytest', 'settingsnew[mytest]', $settings['mytest'], 'radio');

保存，刷新页面发现在这个页面最下方多出一个选项：
settings_mytest      是      否
但是发现其是英文的，我们修改一下语言包就可以了。在templates/default/admincp.lang.php 文件的第 450 行 'settings_closedreason_comment' => ' 论坛关闭时出现的提示信息' ，下面添加如下代码：

代码如下：
'settings_mytest' => '测试选项:',
'settings_mytest_comment' => '测试选项的提示信息',

保存后再刷新就有中文提示了。
至此在界面上的显示已经处理完毕，下面来说一下如何处理表单提交后的数据。在/admin/settings.inc.php 文件的 if(!submitcheck('settingsubmit')) {} 对应的 else 语句部分。这部分的代码，首先对提交过来的数据进行处理，然后全部放到 $settingsnew 数组中，其实也就是 POST 过来的数据进行一下检查。在这个文件的 1140 行左右有如下代码：

代码如下：
foreach($settingsnew AS $key => $val) {
        if(isset($settings[$key]) && $settings[$key] != $val) {
            $$key = $val;
            $updatecache = TRUE;
            if(in_array($key, array('newbiespan', 'topicperpage', 'postperpage', 'memberperpage', 'hottopic',
         'starthreshold', 'delayviewcount', 'visitedforums', 'maxsigrows', 'timeoffset', 'statscachelife',
        'pvfrequence', 'oltimespan', 'seccodestatus', 'maxprice', 'rssttl', 'rewritestatus', 'bdaystatus',
        'maxonlines', 'loadctrl', 'floodctrl', 'regctrl', 'regfloodctrl', 'searchctrl', 'extcredits1', 'extcredits2',
        'extcredits3', 'extcredits4', 'extcredits5', 'extcredits6', 'extcredits7', 'extcredits8',
        'transfermincredits', 'exchangemincredits', 'maxincperthread', 'maxchargespan', 'maxspm',
       'maxsearchresults', 'maxsmilies', 'threadmaxpages', 'membermaxpages', 'maxpostsize',
       'minpostsize', 'maxavatarsize', 'maxavatarpixel', 'maxpolloptions', 'karmaratelimit', 'losslessdel',
       'edittimelimit', 'smcols', 'watermarktrans', 'watermarkquality', 'jscachelife', 'waptpp', 'wapppp',
        'wapmps', 'maxmodworksmonths', 'frameon', 'maxonlinelist'))) {
                $val = (float)$val;
            }
            $db->query("REPLACE INTO {$tablepre}settings (variable, value) VALUES ('$key', '$val')");
        }
    }

这段代码的作用就是检查 $settingsnew 数组中是否有对应的选项，如果有并且是数字选项时进行 float 转换，然后全部 REPLACE INTO 到数据表 settings 中， mytest 选项是我们新添加的，数据表中没有这个选项，我需要先在数据库中执行如下 SQL 语句： REPLACE INTO cdb_settings(variable, value) VALUES('mytest', '0') ，注意修改一下表前缀。这们的 mytest 选项就会存入数据库中。

在 1160 行左右会执行代码 updatecache('settings') 来把 settingsnew 数组里的数据自动进行缓存，具体实现方法有兴趣的朋友可以仔细看一下 /include/cache.func.php 文件是如何实现的。

数据进行缓存后会在 /forumdata/cache/cache_settings.php 文件中 $_DCACHE['settings'] 数组中有 mytest 项，然后我们就可以通过这个选项来做一些操作。在 /include/common.inc.php 文件的第 93 行左右有如下代码：

代码如下：
$cachelost = (@include DISCUZ_ROOT.'./forumdata/cache/cache_settings.php') ? '' : 'settings';
@extract($_DCACHE['settings']);
通过上面的代码，直接把 mytest 配置选项的值用 $mytest 变量来存放，我们就可以直接判断 $mytest 来进行操作了。在 index.php 文件的 17 行加入如下代码：

代码如下：
if($mytest) {
    echo 'Hello This is Test';
}

运行后，效果如下：

图2

至此已经成功的为 Discuz! 论坛添加了一个选项，论坛当然还有相当的选项，其基本思路都是这样的，可以根据具体情况来进行添加。