一、插件實現(xiàn)流程
開始編寫社區(qū)插件,您應(yīng)當首先對插件實現(xiàn)的流程有一個大致的了解,以下是我們推薦的插件編寫流程:
1、熟練使用 discuz! 社區(qū)系統(tǒng)后,對希望完善或補充的個性化功能進行評估,進而提出插件的功能需求。
2、對插件做一個概括性的設(shè)計,例如:需要使用什么菜單、什么參數(shù),配置哪些選項、數(shù)據(jù)結(jié)構(gòu)如何設(shè)計、前后臺實現(xiàn)哪些功能等等。
3、閱讀本文檔并在系統(tǒng)設(shè)置中實際體驗 Discuz! 插件接口所實現(xiàn)的功用,例如:您的插件應(yīng)當如何設(shè)計才能良好的掛接到社區(qū)系統(tǒng)中來。插件接口能夠?qū)崿F(xiàn)哪些功能、不能實現(xiàn)哪些功能,插件為此而需要做的優(yōu)化、改造和取舍。
4、編寫相應(yīng)程序代碼和模板語句,實現(xiàn)所需的功能并進行代碼測試、兼容性測試和代碼改進。
5、如果需要公開您的插件,可以用插件導(dǎo)出的方式,將插件配置信息導(dǎo)出到一個 XML 文件中,連同相應(yīng)的程序和模板文件一同打包。同時,編寫一個適合新手的插件的說明書也是必不可少的,其中包括:插件適用的 Discuz! 版本、功能概述、兼容性聲明、安裝方法、使用方法、卸載方法等等。
6、將插件提供給他人,或自己使用,根據(jù)使用者反饋,對插件進行完善。插件實現(xiàn)流程至此結(jié)束。
二、文件命名規(guī)范
Discuz! 按照如下的規(guī)范對程序和模板進行命名,請在設(shè)計插件時盡量遵循此命名規(guī)范:
1、可以直接通過瀏覽器訪問的普通程序文件,以 .php 后綴命名。
2、被普通程序文件引用的程序文件,以 .inc.php 后綴命名。
3、被普通程序文件,或引用程序文件引用的函數(shù)庫或類庫,以 .func.php(函數(shù)庫) 或 .class.php(類庫) 后綴命名。
4、模板文件,以 .htm 后綴命名,插件模板文件存在于 source/plugin/identifier/template/ 目錄中,手機版插件模板存在于 source/plugin/identifier/template/mobile/目錄中
5、模板語言包文件,以 .lang.php 后綴命名,插件語言包文件開發(fā)時存放于 data/plugindata/ 目錄中,文件名identifier.lang.php。
6、動態(tài)緩存文件,存放于 ./data/cache 目錄中,依據(jù)不同的功用進行獨立的命名。
7、使用后臺數(shù)據(jù)備份功能生成的備份文件,通常以 .sql 為后綴,存放于 data/ 目錄中。
8、有些目錄中存在內(nèi)容為空白的 index.htm 文件,此類文件是為了避免 Web 服務(wù)器打開 Directory Index 時可能產(chǎn)生的安全問題。
9、[X2.5新增內(nèi)容] 從 Discuz! X2.5 開始,產(chǎn)品對數(shù)據(jù)表進行了封裝,封裝后的文件統(tǒng)一命名為 Table 類,通過“C::t(Table類文件名)”方式調(diào)用。插件如需封裝自己的數(shù)據(jù)表,可將 Table 類文件存放于 source/plugin/identifier/table/ 目錄下,并以 table_表名.php 格式命名,詳見X2.5的新程序架構(gòu)。
三、class_core.php 模塊功能白皮書
source/class/class_core.php 是 Discuz! 的通用初始化模塊程序,其幾乎被所有的外部代碼所引用,在您開始插件設(shè)計之前,可以先對該模塊的大致功能做一定的了解。class_core.php 主要完成了以下任務(wù):
1、對不同 PHP 及操作系統(tǒng)環(huán)境做了判斷和兼容性處理,使得 Discuz! 可以運行于各種不同配置的服務(wù)器環(huán)境下。
2、初始化常量 IN_DISCUZ 為 TRUE,用于 include 或 require 后續(xù)程序的判斷,避免其他程序被非法引用。
3、讀取社區(qū)程序所在絕對路徑,存放于常量 DISCUZ_ROOT 中。
4、加載所需的基本函數(shù)庫 source/function/function_core.php。
5、通過 config/config_global.php 中提供的數(shù)據(jù)庫賬號信息,建立數(shù)據(jù)庫連接。Discuz! 支持數(shù)據(jù)表的前綴,如需獲得表的全名,可使用“DB::table('tablename')”方式。
6、判斷用戶是否登錄,如登錄標記 $_G['uid'] 為非 0,同時將 $_G['username'](加了 addslashes 的用戶名,可用于不加修改的插入數(shù)據(jù)庫)、 $_G['member']['username'](原始的用戶名,可用于頁面顯示)、$_G['member']['password'](用戶密碼的MD5串)等相應(yīng)用戶信息賦值,其他用戶信息存放于 $_G['member'],更多信息可通過“getuserprofile()”獲取。
7、判斷用戶管理權(quán)限,將管理權(quán)限標記 $_G['adminid'] 為 1~3 中間的值。0 代表普通用戶;1 代表論壇管理員;2 代表超級版主;3 代表論壇版主。 將用戶權(quán)限按照其所在的主用戶組 ID 標記為 $_G['groupid'],相關(guān)權(quán)限從該 $_G['groupid'] 所對應(yīng)的系統(tǒng)緩存中讀出,存放于 $_G['group']。
8、預(yù)置讀入了每個模塊的各種設(shè)置變量。
9、[X2.5變更內(nèi)容] $_G['username'] 將不進行 addslashes 處理。
此文由 網(wǎng)站目錄_網(wǎng)站網(wǎng)址收錄與提交入口 編輯,未經(jīng)允許不得轉(zhuǎn)載!: