DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> WEB網站前端 >> 前端技巧
Discuz! 論壇二次開發:如何新增自訂配置選項
編輯:前端技巧     

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! 論壇新增了一個選項。論壇當然還有大量選項,但基本思路都是如此,可依具體情況靈活添加。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved