Discuz! 論壇後台有許多配置選項,透過它們能實現各種功能。在 Discuz! 的二次開發過程中,我們也常需要新增一些配置,再依配置進行不同操作。本文就以 Discuz! 6.0 為例,說明如何新增一個配置選項。
先以管理員身份登入後台,依序選擇「基本設置」→「基本設置」,就會出現設定頁面。
這個頁面用了框架。在右下方頁面按右鍵選「內容」,可看到它的 URL 是 /admincp.php?action=settings&do=basic,對應的程式是 admincp.php。先來分析這個檔案:它第 172~290 行大致是根據 $action 變量給 $cpscript 賦值,再依 $cpscript 的值引入 admin 目錄下的程式檔。注意 $action == 'settings' 時,$cpscript 的值是 'settings',也就是說引入的檔案是 admin/settings.inc.php。
打開 settings.inc.php,別被它一長串的內容嚇到,仔細看其實很清楚。第 14 行 $operation = $operation ? $operation : (!empty($do) ? $do : ''); 會依 GET 過來的 $do 給 $operation 賦值,此例中其值為 'basic'。第 17 行則從資料庫把設定讀進陣列 $settings 中備用。接著的結構是:以 submitcheck('settingsubmit') 判斷表單是否提交——若未提交,就依 $operation 顯示表單;此例 $operation 為 'basic',會執行一段用 showsetting() 輸出各欄位的程式:
$operation = 'basic';
showtype('settings_general', 'top');
showsetting('settings_bbname', 'settingsnew[bbname]', $settings['bbname'], 'text');
showsetting('settings_sitename', 'settingsnew[sitename]', $settings['sitename'], 'text');
...(其餘略)
這裡用到的自訂函式 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' => '測試選項的提示信息',
存檔後重新整理,就有中文提示了。至此,界面顯示處理完畢。
接著處理 if(!submitcheck('settingsubmit')) {} 對應的 else 部分。這段程式先對送過來的資料做檢查,全部放進 $settingsnew 陣列。在檔案第 1140 行左右有:
foreach($settingsnew AS $key => $val) {
if(isset($settings[$key]) && $settings[$key] != $val) {
$$key = $val;
$updatecache = TRUE;
if(in_array($key, array('newbiespan', 'topicperpage', ... 等大量數字型選項))) {
$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')
接著,第 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 變量。於是只要在 index.php 第 17 行加入:
if($mytest) {
echo 'Hello This is Test';
}
運行後便能看到效果:
至此,我們已成功為 Discuz! 論壇新增了一個選項。論壇當然還有大量選項,但基本思路都是如此,可依具體情況靈活添加。