WEB开发网
开发学院CMS教程discuz Discuz! 论坛如何添加配置选项 阅读

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

 2009-10-17 11:32:00 来源:WEB开发网   
核心提示:作者:xiaojia 来源:《PHPer》杂志Discuz! 论坛在后台有很多配置选项,通过这些配置选项可以实现很多功能,Discuz! 论坛如何添加配置选项,在 Discuz!论坛的二次开发过程中,我们也同样要经常添加一些配置,在 /include/common.inc.php 文件的第 93 行左右有如下代码:代

作者:xiaojia  来源:《PHPer》杂志

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

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

这个页面用了框架,我们在右下方的页面中点击右键选择‘属性’,在弹出的窗口中,我们发现这个页面的 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';
}

Tags:Discuz 论坛 如何

编辑录入:爽爽 [复制链接] [打 印]
赞助商链接