DiscuzX3x模板插件開發(fā)制作教程

一、開發(fā)插件所需資料與工具1、DiscuzX3插件機(jī)制插件機(jī)制Discuz!擁有一套完整的插件機(jī)制。合理使用插件機(jī)制，你可以更好的將自己的個(gè)性功能需求整合到Discuz!產(chǎn)品中的同時(shí)，保持代碼獨(dú)立，并且不受后續(xù)Discuz!產(chǎn)品版本升級(jí)的影響。我們鼓勵(lì)并推薦，使用插件機(jī)制進(jìn)行個(gè)性需求定制和研發(fā)。插件設(shè)計(jì)的準(zhǔn)備工作插件實(shí)現(xiàn)流程開始編寫社區(qū)插件，您應(yīng)當(dāng)首先對(duì)插件實(shí)現(xiàn)的流程有一個(gè)大致的了解，以下是我們推薦的插件編寫流程：?熟練使用Discuz!社區(qū)系統(tǒng)后，對(duì)希望完善或補(bǔ)充的個(gè)性化功能進(jìn)行評(píng)估，進(jìn)而提出插件的功能需求。?對(duì)插件做一個(gè)概括性的設(shè)計(jì)，例如：需要使用什么菜單、什么參數(shù)，配置哪些選項(xiàng)、數(shù)據(jù)結(jié)構(gòu)如何設(shè)計(jì)、前后臺(tái)實(shí)現(xiàn)哪些功能等等。?閱讀本文檔并在系統(tǒng)設(shè)置中實(shí)際體驗(yàn)Discuz!插件接口所實(shí)現(xiàn)的功用，例如：您的插件應(yīng)當(dāng)如何設(shè)計(jì)才能良好的掛接到社區(qū)系統(tǒng)中來。插件接口能夠?qū)崿F(xiàn)哪些功能、不能實(shí)現(xiàn)哪些功能，插件為此而需要做的優(yōu)化、改造和取舍。?編寫相應(yīng)程序代碼和模板語句，實(shí)現(xiàn)所需的功能并進(jìn)行代碼測試、兼容性測試和代碼改進(jìn)。?如果需要公開您的插件，可以用插件導(dǎo)出的方式，將插件配置信息導(dǎo)出到一個(gè)XML文件中，連同相應(yīng)的程序和模板文件一同打包。同時(shí)，編寫一個(gè)適合新手的插件的說明書也是必不可少的，其中包括：插件適用的Discuz!版本、功能概述、兼容性聲明、安裝方法、使用方法、卸載方法等等。?將插件提供給他人，或自己使用，根據(jù)使用者反饋，對(duì)插件進(jìn)行完善。插件實(shí)現(xiàn)流程至此結(jié)束。?文件命名規(guī)范Discuz!按照如下的規(guī)范對(duì)程序和模板進(jìn)行命名，請(qǐng)?jiān)谠O(shè)計(jì)插件時(shí)盡量遵循此命名規(guī)范：?可以直接通過瀏覽器訪問的普通程序文件，以.php后綴命名。?被普通程序文件引用的程序文件，以.inc.php后綴命名。?被普通程序文件，或引用程序文件引用的函數(shù)庫或類庫，以.func.php（函數(shù)庫）或.class.php（類庫）后綴命名。?模板文件，以.htm后綴命名，插件模板文件存在于source/plugin/identifie/template/目錄中，手機(jī)版插件模板存在于source/plugin/identifiei/template/mobile/目錄中?模板語言包文件，以.lang.php后綴命名，插件語言包文件開發(fā)時(shí)存放于data/plugindata/目錄中，文件名為identifierlang.php。?動(dòng)態(tài)緩存文件，存放于./data/cache目錄中，依據(jù)不同的功用進(jìn)行獨(dú)立的命名。?使用后臺(tái)數(shù)據(jù)備份功能生成的備份文件，通常以.sql為后綴，存放于data/目錄中。?有些目錄中存在內(nèi)容為空白的index.htm文件，此類文件是為了避免Web服務(wù)器打開DirectoryIndex時(shí)可能產(chǎn)生的安全問題。?[X2.5新增內(nèi)容]從Discuz!X2.5開始，產(chǎn)品對(duì)數(shù)據(jù)表進(jìn)行了封裝，封裝后的文件統(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è)計(jì)之前，可以先對(duì)該模塊的大致功能做一定的了解。class_core.php主要完成了以下任務(wù)：?對(duì)不同PHP及操作系統(tǒng)環(huán)境做了判斷和兼容性處理，使得Discuz!可以運(yùn)行于各種不同配置的服務(wù)器環(huán)境下。?初始化常量IN_DISCUZ為TRUE，用于include或require后續(xù)程序的判斷，避免其他程序被非法引用。?讀取社區(qū)程序所在絕對(duì)路徑，存放于常量DISCUZ_ROOT中。?加載所需的基本函數(shù)庫source/function/function_core.php。?通過config/config_global.php中提供的數(shù)據(jù)庫賬號(hào)信息，建立數(shù)據(jù)庫連接。 Discuz!支持?jǐn)?shù)據(jù)表的前綴，如需獲得表的全名，可使用“DB::table（'tablename'）”方式。?判斷用戶是否登錄，如登錄標(biāo)記$_G['uid']為非0，同時(shí)將$_G['username']（加了addslashes的用戶名，可用于不加修改的插入數(shù)據(jù)庫）、$_G['member']['username']（原始的用戶名，可用于頁面顯示）、$_G['member']['password']（用戶密碼的MD5串）等相應(yīng)用戶信息賦值，其他用戶信息存放于$_G['member']，更多信息可通過“getuserprofile（）”獲取。?判斷用戶管理權(quán)限，將管理權(quán)限標(biāo)記$_G['adminid']為1~3中間的值。0代表普通用戶；1代表論壇管理員；2代表超級(jí)版主；3代表論壇版主。將用戶權(quán)限按照其所在的主用戶組ID標(biāo)記為$_G['groupid']，相關(guān)權(quán)限從該$_G['groupid']所對(duì)應(yīng)的系統(tǒng)緩存中讀出，存放于$_G['group']。?預(yù)置讀入了每個(gè)模塊的各種設(shè)置變量。?[X2.5變更內(nèi)容]$_G['username']將不進(jìn)行addslashes處理。插件接口概述使用管理員賬號(hào)登錄Discuz!管理中心，在頂部菜單將可以看到“插件”菜單?！安寮斜怼绷谐隽怂幸寻惭b的插件，是控制插件打開與否、設(shè)計(jì)插件模塊、菜單、參數(shù)和使用權(quán)限的地方，插件開發(fā)者可以依照設(shè)計(jì)意圖，在此進(jìn)行插件的初步設(shè)置，這里同時(shí)也提供插件導(dǎo)入和插件開關(guān)的功能，用于導(dǎo)入他人設(shè)計(jì)的插件和對(duì)插件的可用狀態(tài)進(jìn)行變更。開始編寫一個(gè)新插件，請(qǐng)首先打開config/config_global.php文件，在文件結(jié)尾添加以下代碼開啟插件設(shè)計(jì)者模式。?$_config['plugindeveloper']=1;在插件管理中選擇“設(shè)計(jì)新插件”，填寫插件名稱，名稱用于表明此插件的用途，例如設(shè)置為'虛擬銀行插件”。惟一標(biāo)識(shí)符用于在后續(xù)的插件模塊中調(diào)用本插件，不可與現(xiàn)有插件重復(fù)，命名規(guī)則限制與PHP變量命名相同，雖然初次設(shè)置后仍可改動(dòng)，但強(qiáng)烈建議一次性將此配置設(shè)置好，否則可能涉及到很多代碼方面的變更，增加編碼的麻煩。請(qǐng)注意：惟一標(biāo)識(shí)符請(qǐng)不要設(shè)置的過短，或使用有可能與其他插件重復(fù)的命名，例如制作此插件的公司叫做ComsenzInc.，插件名稱是“虛擬銀行插件”，惟一標(biāo)識(shí)符可設(shè)置為“comsenz_virtual_bank”。最后在source/plugin/目錄中創(chuàng)建與唯一標(biāo)識(shí)符同名的目錄名，如source/plugin/comsenz_virtual_bank/。在插件管理中添加插件后，僅僅是增加了一條插件記錄，后面還需要很多相關(guān)的設(shè)計(jì)和設(shè)置。在列表中選擇插件的'詳情”進(jìn)入插件的詳細(xì)設(shè)置。插件設(shè)置分為三個(gè)部分：?插件模塊插件模塊分為程序鏈接、擴(kuò)展項(xiàng)目和程序腳本3類：程序鏈接主導(dǎo)航項(xiàng)目：可在主導(dǎo)航欄增加一個(gè)菜單項(xiàng)，可自主指派菜單鏈接的URL，也可以調(diào)用插件的一個(gè)模塊，模塊文件名指派為source/plugin/插件目錄/插件模塊名.inc.php”。注意：由于引用外部程序，因此即便設(shè)置了模塊的使用等級(jí)，您的程序仍需進(jìn)行判斷使用等級(jí)是否合法。?程序鏈接主導(dǎo)航項(xiàng)目-插件菜單：可在主導(dǎo)航欄的插件子菜單中增加一個(gè)菜單項(xiàng)。?程序鏈接頂部導(dǎo)航項(xiàng)目、底部導(dǎo)航項(xiàng)目、快捷導(dǎo)航項(xiàng)目、家園導(dǎo)航項(xiàng)目：可在各個(gè)導(dǎo)航中增加一個(gè)菜單項(xiàng)。?擴(kuò)展項(xiàng)目個(gè)人設(shè)置：可在個(gè)人設(shè)置中增加一個(gè)菜單項(xiàng)。?擴(kuò)展項(xiàng)目個(gè)人設(shè)置-個(gè)人資料：可在個(gè)人設(shè)置的個(gè)人資料頁上部增加一個(gè)菜單項(xiàng)。?擴(kuò)展項(xiàng)目個(gè)人設(shè)置-積分：可在個(gè)人設(shè)置的積分頁上部增加一個(gè)菜單項(xiàng)。?擴(kuò)展項(xiàng)目站點(diǎn)幫助：可在站點(diǎn)幫助中增加一個(gè)菜單項(xiàng)。?擴(kuò)展項(xiàng)目我的帖子：可在我的帖子中增加一個(gè)菜單項(xiàng)。?擴(kuò)展項(xiàng)目門戶管理：可在門戶管理面板上部增加一個(gè)菜單項(xiàng)。?擴(kuò)展項(xiàng)目論壇管理-基本：可在前臺(tái)論壇管理面板側(cè)邊上部增加一個(gè)菜單項(xiàng)。?擴(kuò)展項(xiàng)目論壇管理-工具：可在前臺(tái)論壇管理面板側(cè)邊下部增加一個(gè)菜單項(xiàng)。?擴(kuò)展項(xiàng)目管理中心：可在后臺(tái)插件欄目中為此插件增添一個(gè)管理模塊。?程序腳本頁面嵌入-普通版：設(shè)置一個(gè)包含頁面嵌入腳本的模塊，該模塊用于在普通電腦訪問的頁面顯示。模塊文件名指派為source/plugin/插件目錄/插件模塊名.class.php”。（頁面嵌入將在后面的《頁面嵌入模塊開發(fā)》中詳細(xì)說明）?程序腳本頁面嵌入-手機(jī)版：設(shè)置一個(gè)包含頁面嵌入腳本的模塊，該模塊用于在手機(jī)訪問的頁面顯示。?程序腳本特殊主題：設(shè)置一個(gè)特殊主題腳本的模塊，模塊文件名指派為source/plugin/插件目錄/插件模塊名.class.php”。（特殊主題將在后面的《特殊主題模塊開發(fā)》中詳細(xì)說明）?您可以為每個(gè)模塊設(shè)置不同的使用等級(jí)，例如設(shè)置為“超級(jí)版主”，則超級(jí)版主及更高的管理者可以使用此模塊。擴(kuò)展項(xiàng)目模塊可以在社區(qū)的特定位置擴(kuò)展出新的功能，通常用于擴(kuò)展新的設(shè)置項(xiàng)目。項(xiàng)目的腳本文件以.inc.php結(jié)尾（如test.inc.php），模版為固定文件名，位于插件目錄的template/子目錄中，文件名與腳本名同名（如test.htm），擴(kuò)展名為.htm。添加相應(yīng)的擴(kuò)展項(xiàng)目模塊時(shí)，需注明程序模塊、菜單名稱。例如我們添加個(gè)人面板項(xiàng)目，程序模塊為test，菜單名稱是“測試”，當(dāng)插件啟用后，個(gè)人面板即家園的設(shè)置中會(huì)出現(xiàn)“測試”拓展項(xiàng)目。在新插件內(nèi)核中，通過plugin.php方式訪問的插件可直接通過plugin.php?id=xxx:yyy方式調(diào)用而無需再在后臺(tái)定義為普通腳本模塊，只要source/plugin/xxx/yyy.inc.php文件存在即可。如果xxx和yyy同名，可直接通過plugin.php?id=xxx方式訪問。插件變量配置插件接口中提供了一個(gè)通用的插件配置管理程序，在大多數(shù)情況下可實(shí)現(xiàn)插件的參數(shù)配置，省卻了插件開發(fā)者自行編寫后臺(tái)管理模塊(即上面提到的“擴(kuò)展項(xiàng)目管理中心”模塊)的麻煩。通常情況下，應(yīng)優(yōu)先使用通用插件配置管理程序來實(shí)現(xiàn)插件的參數(shù)配置，只有在通用程序確實(shí)無法實(shí)現(xiàn)時(shí)，才自行編寫后臺(tái)管理模塊。輸入配置名稱和配置變量名、選擇合適的配置類型后，即可為此插件增加一個(gè)配置變量，點(diǎn)'詳情”可以編輯此配置變量的更多信息。為了方便插件程序調(diào)用使用者配置好的參數(shù)，配置變量同樣被存放在了緩存文件中，讀取方法將在后面的《插件的參數(shù)讀取與緩存控制》中詳細(xì)說明。注意：您只有在插件管理中將插件設(shè)置為“可用”，以上設(shè)置才能生效。插件的參數(shù)讀取與緩存控制?編寫插件程序時(shí)，可能需要讀取一些插件的信息，如果插件需要使用者進(jìn)行配置，還需要讀取使用者設(shè)置的參數(shù)值。Discuz!允許插件程序使用數(shù)據(jù)庫讀取和緩存讀取這兩種方法獲取插件信息和參數(shù)。Discuz!的插件接口已經(jīng)對(duì)插件信息進(jìn)行了合理的緩存，使用緩存讀取的方式，將比數(shù)據(jù)庫讀取速度更快，消耗的資源更是幾乎可以忽略不計(jì)。緩存讀取唯一的局限是需要插件使用插件接口提供的通用后臺(tái)管理程序。如果使用自定義后臺(tái)模塊的方式，需要后臺(tái)模塊將參數(shù)存放到pluginvars數(shù)據(jù)表中，才能被系統(tǒng)正常緩存。我們強(qiáng)烈推薦您通過緩存讀取插件信息和配置數(shù)據(jù)。?由于調(diào)用系統(tǒng)緩存統(tǒng)一通過Toadcache?！焙瘮?shù)調(diào)用，并存放于$_G['cache']中，因此Toadcache('plugin')”后插件的變量緩會(huì)存放于$_G['cache']['plugin']中。嵌入點(diǎn)插件和以plugin.php為主腳本調(diào)用的插件無需加載此緩存，系統(tǒng)已自動(dòng)加載了緩存。變量配置類型為“版塊/*”的變量會(huì)保存在$_G['cache']['forums'][fid]['plugin']中。變量配置類型為“用戶組/*”的變量會(huì)保存在$_G['cache']['usergroup_groupid']['plugin']和$_G['group']['plugin']中。頁面嵌入模塊開發(fā)頁面嵌入類型腳本格式＜?php//全局嵌入點(diǎn)類(必須存在)classplugin_identifier{functionHookId_1(){return...;}functionHookId_2(){return...;} }//腳本嵌入點(diǎn)類classplugin_identifier_CURSCRIPTextendsplugin_identifier{functionHookId_1(){return...;}functionHookId_2(){return...;}......}?>plugin_?普通版腳本中的類名以plugin_開頭。手機(jī)版腳本中的類名以mobileplugin_開頭。identifier?插件的唯一標(biāo)識(shí)符，在插件設(shè)置中設(shè)置。CURSCRIPT?嵌入點(diǎn)位于的腳本名，如forum.php為forum。HookId函數(shù)名調(diào)用位置聲明位置參數(shù)含義HookId；)所有模塊執(zhí)行前被調(diào)用腳本嵌入點(diǎn)類HookId_output($value)模塊執(zhí)行完畢，模板輸出前被調(diào)用腳本嵌入點(diǎn)類$value:array('template'=>當(dāng)前要輸出的模版,'message'=>showmessage的信息內(nèi)容,'values'=>showmessage的信息變量，)global_HookIc()模塊執(zhí)行完畢，模板輸出前被調(diào)用全局嵌入點(diǎn)類HookId_message($value)showmessage()執(zhí)行時(shí)調(diào)用腳本嵌入點(diǎn)類$value:array('param'=>showmessage()函數(shù)的參數(shù)數(shù)組，)ad_adId($value)相應(yīng)的廣告位中調(diào)用函數(shù)名為廣告位腳本ID如：ad_headerbanner()全局嵌入點(diǎn)類腳本嵌入點(diǎn)類$value:array('params'=>廣告位參數(shù),'content'=>當(dāng)前廣告位原本將要顯示的內(nèi)容，)

common()所有模塊執(zhí)行前被調(diào)用全局嵌入點(diǎn)類discuzcode($value)discuzcode()函數(shù)執(zhí)行時(shí)調(diào)用用于在帖子內(nèi)容解析時(shí)嵌入自己的功能，函數(shù)中$_G['discuzcodemessage']變量為待解析的字串全局嵌入點(diǎn)類$value:array('param'=>caller函數(shù)的參數(shù)數(shù)組,'caller'=>caller函數(shù)，此嵌入點(diǎn)被哪個(gè)函數(shù)調(diào)用'discuzcode'被discuzcode()調(diào)用'messagecutstr'被messagecutstr()調(diào)用)deletethread($value)deletethread()函數(shù)執(zhí)行時(shí)調(diào)用用于在主題刪除前后嵌入自己的功能，此函數(shù)將在deletethread()中被調(diào)用2次，函數(shù)中$_G['deletethreadtids']變量為待處理的TID數(shù)組全局嵌入點(diǎn)類$value:array('param'=>deletethread()函數(shù)的參數(shù)數(shù)組,'step'=>刪除的步驟'check'檢測步驟'delete'刪除步驟)deletepost($value)deletepost()函數(shù)執(zhí)行時(shí)調(diào)用用于在帖子刪除前后嵌入自己的功能，此函數(shù)將在deletepost()中被調(diào)用2次，函數(shù)中$_G['deletepostids']變量為待處理的ID數(shù)組全局嵌入點(diǎn)類$value:array('param'=>deletepost()函數(shù)的參數(shù)數(shù)組,'step'=>刪除的步驟'check'檢測步驟'delete'刪除步驟)avatar($value)(X2.5新增)avatar()函數(shù)執(zhí)行時(shí)調(diào)用用于在頭像調(diào)用時(shí)嵌入自己的功能，函數(shù)中$_G['hookavatar']變量為新頭像返回值全局嵌入點(diǎn)類$value:array('param'=>avatar()函數(shù)的參數(shù)數(shù)組)profile_node($post,$start,$end)(X3.0新增)貼內(nèi)用戶信息標(biāo)記，返回值為標(biāo)記顯示內(nèi)容全局嵌入點(diǎn)類$post:當(dāng)前帖子信息數(shù)組$start:用戶填寫的前置字符$end:用戶填寫的后置字符要查看所有的預(yù)定義嵌入點(diǎn)，請(qǐng)打開config/config_global.php文件，將文件結(jié)尾添加的設(shè)計(jì)者模式值改成“2”,然后更新緩存即可。在頁面源碼中查找"<hook>"可搜索到嵌入點(diǎn)。(詳細(xì)內(nèi)容可參閱的《插件嵌入點(diǎn)列表》)$_config['plugindeveloper']=2;預(yù)定義的嵌入點(diǎn)會(huì)在頁面預(yù)置好的位置輸出函數(shù)返回的內(nèi)容。函數(shù)返回值類型如果是array且是空值的，必須輸出一個(gè)空數(shù)組，如：returnarray();函數(shù)名并不限于以上列表，您可以自定義，只要符合以下規(guī)則，函數(shù)就會(huì)在適當(dāng)?shù)牡胤奖徽{(diào)用。functionCURMODULE_USERDEFINE[_output]()CURMODULE指明了此函數(shù)在哪個(gè)模塊執(zhí)行，可通過常量CURMODULE得到當(dāng)前頁面的CURMODULE值。USERDEFINE可自定義，如果函數(shù)名以“_output”結(jié)尾則會(huì)在模板輸出前調(diào)用，否則會(huì)在模塊執(zhí)行前調(diào)用。如：attachment_test()函數(shù)會(huì)在論壇的下載附件的時(shí)候執(zhí)行。"_output”結(jié)尾的函數(shù)的第一個(gè)參數(shù)為數(shù)組，含義為array('template'=>要輸出的模板名，'message'=>showmessage的文字)如：以下函數(shù)將在登錄的時(shí)候輸出調(diào)試文字functionlogging_test_output($a){print_r($a);print_r($_POST);}plugin_identifier類中的其它函數(shù)為了便于閱讀建議以“_”開頭，如：<?phpclassplugin_sample{function_updatecache(){return...;}}classplugin_sample_forumextendsplugin_sample{functionviewthread_posttop(){return...;}.....}?>插件嵌入點(diǎn)列表-全局(common/)extcredits.htmstringspacecp_credit_extrafaq.htmstringfaq_extrafooter.htmstringglobal_footerstringglobal_footerlinkheader.htmstringglobal_cpnav_top(X2.5)stringglobal_cpnav_extra1stringglobal_cpnav_extra2stringglobal_qmenu_top(X3)stringglobal_qmenu_bottom(X3)stringglobal_nav_extra(X2.5)stringglobal_headeruserabout.htmarrayglobal_userabout_topstringuserapp_menu_topstringuserapp_menu_middlearrayglobal_userabout_bottomuserstatus.htmstringglobal_usernav_extralstringglobal_usernav_extra2stringglobal_usernav_extra3stringglobal_usernav_extra4(X2.5)-論壇(forum/)collection_all.htm(X2.5)stringcollectionjndex_topstringcollection_index_bottomcollection_comment.htm(X2.5)stringcollection_nav_extracollection_index.htm(X2.5)stringcollectionjndex_topstringcollection_index_bottomcollection_mycollection.htm(X2.5)stringcollectionjndex_topstringcollection_index_bottomcollection_nav.htm(X2.5)stringcollection_nav_extracollection_view.htm(X2.5)stringcollection_viewoptionsstringcollection_view_topstringcollection_threadlistbottomstringcollection_relatedopstringco11ection_view_bottomstringcollection_side_bottomdiscuz.htmstringindex_status_extrastringindex_nav_extra(X2.5)stringindex_topstringindex_catlist_top(X2.5)arrayindex_followcollection_extra(X3)arrayindex_favforum_extra(X2.5)arrayindex_favforum_extra(X3)arrayindex_catlist(X2.5)arrayindex_forum_extra(X2.5)arrayindex_forum_extra(X2.5)arrayindex_datacollection_extra(X3)stringindex_middlestringindex_bottomstringindex_side_topstringindex_side_bottomdiscuzcode.htmarrayviewthread_attach_extra(X2.5)editor_menu_forum.htmstringpost_image_btn_extrastringpost_image_tab_extrastringpost_attach_btn_extrastringpost_attach_tab_extraforumdisplay.htmstringforumdisplay_leftside_topstringforumdisplay_leftside_bottomstringforumdisplay_forumactionstringforumdisplay_modlinkstringforumdisplay_topstringforumdisplay_middlestringforumdisplay_postbutton_topstringforumdisplay_threadtype_inner(X2.5)stringforumdisplay_filter_extra(X2.5)stringforumdisplay_threadtype_extra(X2.5)stringforumdisplay_bottomstringforumdisplay_side_topstringforumdisplay_side_bottomforumdisplay_fastpost.htmstringforumdisplay_fastpost_contentstringforumdisplay_fastpost_func_extrastringforumdisplay_fastpost_ctrl_extrastringglobal_login_textstringforumdisplay_fastpost_upload_extend(X3)stringforumdisplay_fastpost_btn_extrastringforumdisplay_fastpost_sync_methodforumdisplay_list.htmstringforumdisplay_filter_extraarrayforumdisplay_threadarrayforumdisplay_thread_subject(X2.5)arrayforumdisplay_authorarrayforumdisplay_thread(X2.5)arrayforumdisplay_author(X2.5)stringforumdisplay_threadlist_bottom(X2.5)stringforumdisplay_postbutton_bottomforumdisplay_sort.htm(X2.5)stringforumdisplay_postbutton_bottomforumdisplay_subforum.htm(X2.5)arrayforumdisplay_subforum_extraarrayforumdisplay_subforum_extraguide.htmstringguide_nav_extrastringguide_topstringguide_bottomindex_navbar.htmstringindex_navbarpost.htmstringpost_topstringpost_middlestringpost_btn_extrastringpost_sync_methodstringpost_bottomstringpost_upload_extend(X3)post_activity.htmstringpost_activity_extrapost_debate.htmstringpost_debate_extrapost_editor_attribute.htm(X3)stringpost_attribute_extrastringpost_attribute_extra_bodypost_editor_body.htmstringpost_editorctrl_rightstringpost_editorctrl_leftstringpost_editorctrl_topstringpost_editorctrl_bottompost_infloat.htmstringpost_infloat_topstringpost_infloat_middlestringpost_infloat_btn_extrapost_poll.htmstringpost_poll_extrastringpost_poll_upload_extend(X3)post_reward.htmstringpost_reward_extrapost_trade.htmstringpost_trade_extratopicadmin_modlayer.htmstringforumdisplay_modlayerstringmodcp_modlayertrade_info.htmstringviewthread_tradeinfo_extraviewthread.htmstringviewthread_topstringviewthread_postbutton_topstringviewthread_modoptionstringviewthread_beginline(X2.5)stringviewthread_title_extrastringviewthread_title_rowstringviewthread_middlestringviewthread_bottomviewthread_activity.htmstringviewthread_activity_extra1stringviewthread_activity_extra2viewthread_album.htm(X3)stringviewthread_beginlinestringviewthread_useraction_prefixstringviewthread_useractionstringviewthread_bottomviewthread_fastpost.htmstringviewthread_fastpost_sidestringviewthread_fastpost_contentstringviewthread_fastpost_func_extrastringviewthread_fastpost_ctrl_extrastringglobal_login_textstringviewthread_fastpost_upload_extend(X3)stringviewthread_fastpost_btn_extra(X2.5)viewthread_from_node.htmarrayviewthread_postheaderarrayviewthread_postheaderarrayviewthread_postheaderarrayviewthread_endlineviewthread_node.htmarrayviewthread_profiIesidearrayviewthreadjmiconsarrayviewthread_magic_userarrayviewthread_avatararrayviewthread_sidetoparrayviewthread_sidebottomarrayviewthread_postheaderstringviewthread_modaction(X2.5)stringviewthread_share_methodstringviewthread_useractionarrayviewthread_postsightmIafter(X2.5)arrayviewthread_postfooterarrayviewthread_postaction(X2.5)stringviewthread_magic_threadarrayviewthread_magic_postarrayviewthread_endlineviewthread_node_body.htmarrayviewthread_posttopstringglobal_login_textarrayviewthread_postbottomviewthread_poll.htmstringviewthread_poll_topstringviewthread_polLbottomviewthread_portal.htmstringviewthread_useraction_prefixstringviewthread_useractionstringviewthread_side_bottomviewthread_preview_node.htm(X3)arrayviewthread_postheaderarrayviewthread_endlineviewthread_trade.htmarrayviewthread_trade_extra-群組(group/)group.htmstringgroup_navlinkstringforumdisplay_navlinkstringgroup_navlinkstringforumdisplay_navlinkstringgroup_topstringforumdisplay_topstringgroup_nav_extrastringforumdisplay_nav_extrastringgroup_bottomstringforumdisplay_bottomstringgroup_side_bottomstringforumdisplay_side_bottomgroup_list.htmstringforumdisplay_postbutton_topstringforumdisplay_filter_extraarrayforumdisplay_threadstringforumdisplay_postbutton_bottomgroup_my.htmstringmy_headerstringmy_bottomstringmy_side_topstringmy_side_bottomgroup_right.htmstringgroup_index_sidestringgroup_side_topstringforumdisplay_side_topindex.htmstringindex_headerstringindex_topstringindex_bottomstringindex_side_topstringindex_side_bottomtype.htmstringindex_toparrayindex_groupliststringindex_bottomstringindex_side_topstringindex_side_bottom-家園(home/)editor_image_menu.htm(X3)stringspacecp_blog_upload_extendstringportalcp_top_upload_extendfollow_feed.htmstringfollow_nav_extrastringfollow_topstringfollow_upload_extend(X3)stringfollow_nav_extra(X3)spacecp_avatar.htmstringspacecp_avatar_topstringspacecp_avatar_bottomspacecp_blog.htmstringspacecp_blog_topstringspacecp_blog_middlestringspacecp_blog_bottomspacecp_credit_base.htmstringspacecp_credit_topstringspacecp_credit_extrastringspacecp_credit_bottomspacecp_creditjog.htmstringspacecp_credit_topstringspacecp_credit_bottomspacecp_privacy.htmstringspacecp_privacy_topstringspacecp_privacy_base_extrastringspacecp_privacy_feed_extrastringspacecp_privacy_bottomspacecp_profile.htmstringspacecp_profile_topstringspacecp_profile_extrastringspacecp_profile_bottomspacecp_promotion.htmstringspacecp_promotion_topstringspacecp_promotion_bottomspacecp_upload.htm(X3)stringspacecp_upload_extendspacecp_usergroup.htmstringspacecp_usergroup_topstringspacecp_usergroup_bottomstringspacecp_usergroup_topstringspacecp_usergroup_bottomstringspacecp_usergroup_topstringspacecp_usergroup_bottomspace_album_pic.htmstringspace_album_pic_topstringspace_album_pic_op_extrastringspace_album_pic_bottomstringspace_album_pic_face_extraspace_album_view.htmstringspace_album_op_extraspace_blog_list.htmarrayspace_blog_list_statusspace_blog_view.htmstringspace_blog_titlestringspace_blog_share_method(X2.5)stringspace_blog_op_extrastringspace_blog_face_extraspace_card.htmstringspace_card_topstringspace_card_baseinfo_middlestringspace_card_baseinfo_bottomstringspace_card_optionstringspace_card_magic_userstringspace_card_bottomspace_commentji.htmarrayglobal_space_comment_op(X3)stringglobal_comment_bottom(X3)space_doing.htmstringspace_doing_topstringspace_doing_bottomspace_favorite.htmstringspace_favorite_nav_extraspace_friend.htmstringspace_interaction_extraspace_header.htmstringglobal_usernav_extralstringglobal_usernav_extra2space_home.htmstringspace_home_navlink(X3)stringspace_home_side_top(X2.5)stringspace_home_side_bottomstringspace_home_topstringspace_home_navlinkstringspace_home_bottomspace_magic.htm(X2.5)stringmagic_nav_extraspace_medal.htm(X2.5)stringmedal_nav_extraspace_menu.htmstringspace_menu_extraspace_profile_body.htmstringspace_profile_baseinfo_topstringfollow_profile_baseinfo_top(X2.5)stringspace_profile_baseinfo_middlestringfollow_profile_baseinfo_middle(X2.5)stringspace_profile_baseinfo_bottomstringfollow_profile_baseinfo_bottom(X2.5)stringspace_profile_extrainfostringfollow_profile_extrainfo(X2.5)space_share_li.htmarrayspace_share_comment_opspace_status.htmstringspace_home_doing_sync_methodspace_wall.htmstringspace_wall_face_extra?注冊(cè)/登錄(member/)login.htmstringlogging_side_topstringlogging_topstringloggingjnputstringlogging_methodlogin_simple.htmstringglobal_login_extraregister.htmstringregister_side_topstringregister_topstringregisterjnputstringregister_logging_methodstringregister_bottom■門戶(portal/)portalcp_article.htmstringportalcp_topstringportalcp_extendstringportalcp_middlestringportalcp_bottomview.htmstringview_article_top(X2.5)stringview_article_subtitle(X2.5)stringview_article_summary(X2.5)stringview_article_content(X2.5)stringview_share_methodstringview_article_op_extra(X2.5)stringview_article_side_top(X2.5)stringview_article_side_bottom(X2.5)-排行榜(ranklist/)side_left.htmstringranklist_nav_extra-搜索(search/)album.htmstringalbum_topstringalbum_bottomblog.htmstringblog_topstringblog_bottomcollection.htm(X3)stringcollection_topstringcollection_bottomfooter.htmstringglobal_footerstringglobal_footerlinkforum.htmstringforum_topstringforum_bottomgroup.htmstringgroup_topstringgroup_bottomheader.htmstringglobal_usernav_extralstringglobal_usernav_extra2portal.htmstringportal_topstringportal_bottom-應(yīng)用(userapp/)userapp_app.htmstringuserapp_app_topstringuserapp_app_bottomuserapp_index.htmstringuserapp_index_topstringuserapp_index_bottomuserapp_menu_list.htmstringuserapp_menu_topstringuserapp_menu_middlestringuserapp_menu_bottom-手機(jī)全局(mobile/common/)footer.htmstringglobal_footer_mobileheader.htmstringglobal_header_mobile-手機(jī)論壇(mobile/forum/)discuz.htmstringindex_top_mobilestringindex_middle_mobilestringindex_bottom_mobileforumdisplay.htmstringforumdisplay_top_mobilearrayforumdisplay_thread_mobilestringforumdisplay_bottom_mobileviewthread.htmstringviewthread_top_mobilearrayviewthread_posttop_mobilearrayviewthread_postbottom_mobilestringviewthread_bottom_mobiIe-手機(jī)論壇(wml/forum/)discuz.htmstringindex_top_mobilestringindex_middle_mobileforumdisplay.htmstringforumdisplay_top_mobilearrayforumdisplay_thread_mobilestringforumdisplay_bottom_mobileviewthread.htmstringviewthread_top_mobilearrayviewthread_posttop_mobilearrayviewthread_postbottom_mobilestringviewthread_bottom_mobiIe特殊主題模塊開發(fā)特殊主題模塊用于創(chuàng)建一個(gè)特殊主題，特殊主題類型腳本格式<?phpclassthreadpluginjdentifier{var$name='XX主題'；〃主題類型名稱var$iconfile='icon.gif;〃發(fā)布主題鏈接中的前綴圖標(biāo)var$buttontext='發(fā)布xx主題'；〃發(fā)帖時(shí)按鈕文字functionnewthread($fid){return}functionnewthread_submit($fid){}functionnewthread_submit_end($fid,$tid){}functioneditpost($fid,$tid){return}functioneditpost_submit($fid,$tid){}functioneditpost_submit_end($fid,$tid){}functionnewreply_submit_end($fid,$tid){}functionviewthread($tid){return...;}}?>identifier插件的唯一標(biāo)識(shí)符，在插件設(shè)置中設(shè)置。函數(shù)名以及含義函數(shù)名含義newthread()發(fā)主題時(shí)頁面新增的表單項(xiàng)目，通過return返回即可輸出到發(fā)帖頁面中newthread_submit()主題發(fā)布后的數(shù)據(jù)判斷newthread_submit_end()主題發(fā)布后的數(shù)據(jù)處理editpost()編輯主題時(shí)頁面新增的表單項(xiàng)目，通過return返回即可輸出到編輯主題頁面中editpost_submit()主題編輯后的數(shù)據(jù)判斷editpost_submit_end()主題編輯后的數(shù)據(jù)處理newreply_submit_end()回帖后的數(shù)據(jù)處理viewthread()查看主題時(shí)頁面新增的內(nèi)容，通過return返回即可輸出到主題首貼頁面中第三方拓展類的開發(fā)目錄［隱藏］?1廣告類2道具類3任務(wù)類4驗(yàn)證問答類5驗(yàn)證碼類(Discuz!X2.5新增)廣告類腳本位置：source/class/adv/adv_name.php語言包位置：source/language/adv/lang_name.php【Discuz!X3.0新增】腳本位置：source/plugin/插件目錄/adv/.php縮略圖：source/plugin/插件目錄/adv/adv_name.gif<?phpclassadv_name{var$version='1.0';//腳本版本號(hào)var$name='name';//廣告類型名稱(可填寫語言包項(xiàng)目)var$description='desc'y/廣告類型說明(可填寫語言包項(xiàng)目)var$copyright='ComsenzInc.';//版權(quán)(可填寫語言包項(xiàng)目)var$targets=array('portal','home','member','forum','group','userapp','plugin','custom');//廣告類型適用的投放范圍var$imagesizes=array('120x60','120x240');//圖片廣告推薦大小functiongetsetting(){//返回設(shè)置項(xiàng)目$settings=array('text'=>array('title'=>'text_title',//設(shè)置項(xiàng)目名稱(可填寫語言項(xiàng)目)'type'=>'mradio',//項(xiàng)目類型'value'=>array(),〃項(xiàng)目選項(xiàng)'default'=>0,//項(xiàng)目默認(rèn)值));return$settings;}functionsetsetting(&$advnew,&$parameters){//保存設(shè)置項(xiàng)目}functionevalcode(){//廣告顯示時(shí)的運(yùn)行代碼returnarray(〃檢測廣告是否投放時(shí)的代碼'check'=>'if(condition){$checked=false;}',〃廣告顯示時(shí)的代碼(隨機(jī)調(diào)用投放的廣告)'create'=>'$adcode=$codes[$adids[array_rand($adids)]];',)；}}?>道具類腳本位置：source/class/magic/magic_name.php語言包位置：source/language/magic/lang_name.php【Discuz!X3.0新增】腳本位置：source/plugin/插件目錄/magic/.php圖標(biāo)：source/plugin/插件目錄/magic/magic_name.small.gif、source/plugin/插件目錄/magic/magic_name.gif<?phpclassmagic_name{var$version='1.0';//腳本版本號(hào)var$name='name';//道具名稱(可填寫語言包項(xiàng)目)var$description='desc';//道具說明(可填寫語言包項(xiàng)目)var$price='10';//道具默認(rèn)價(jià)格var$weight='10';//道具默認(rèn)重量var$copyright='ComsenzInc.';//版權(quán)(可填寫語言包項(xiàng)目)functiongetsetting(){//返回設(shè)置項(xiàng)目$settings=array('text'=>array('title'=>'text_title',//設(shè)置項(xiàng)目名稱(可填寫語言項(xiàng)目)'type'=>'mradio',//項(xiàng)目類型'value'=>array(),〃項(xiàng)目選項(xiàng)'default'=>0,//項(xiàng)目默認(rèn)值));return$settings;}functionsetsetting(&$advnew,&$parameters){//保存設(shè)置項(xiàng)目}functionusesubmit($magic,$parameters){//道具使用}functionshow($magic){//道具顯示}}?>任務(wù)類腳本位置：source/class/task/task_name.php語言包位置：source/language/task/lang_name.php【Discuz!X3.0新增】腳本位置：source/plugin/插件目錄/task/.php圖標(biāo)：source/plugin/插件目錄/task/.gif<?phpclasstask_name{var$version='1.0';//腳本版本號(hào)var$name='name';//任務(wù)名稱(可填寫語言包項(xiàng)目)var$description='desc';//任務(wù)說明(可填寫語言包項(xiàng)目)var$copyright='ComsenzInc.';//版權(quán)(可填寫語言包項(xiàng)目)var$icon=〃〃默認(rèn)圖標(biāo)var$period='';//默認(rèn)任務(wù)間隔周期var$periodtype=0;//默認(rèn)任務(wù)間隔周期單位var$conditions=array(〃任務(wù)附加條件'text'=>array('title'=>'text_title',//設(shè)置項(xiàng)目名稱(可填寫語言項(xiàng)目)'type'=>'mradio',//項(xiàng)目類型'value'=>array(),〃項(xiàng)目選項(xiàng)'default'=>0,//項(xiàng)目默認(rèn)值'sort'=>'complete',//條件類型(apply:申請(qǐng)任務(wù)條件complete:完成任務(wù)條件)),);functionpreprocess($task){//申請(qǐng)任務(wù)成功后的附加處理}functioncsc（$task=array。）{/判斷任務(wù)是否完成（返回TRUE:成功FALSE:失敗0:任務(wù)進(jìn)行中進(jìn)度未知或尚未開始大于0的正數(shù):任務(wù)進(jìn)行中返回任務(wù)進(jìn)度）}functionsufprocess（$task）{//完成任務(wù)后的附加處理}functionview（$task,$taskvars）{//任務(wù)顯示}functioninstall（）{//任務(wù)安裝的附加處理}functionuninstall。{//任務(wù)卸載的附加處理}functionupgrade（）{//任務(wù)升級(jí)的附加處理}}?>驗(yàn)證問答類腳本位置：source/class/secqaa/secqaa_name.php語言包位置：source/language/secqaa/lang_name.php【Discuz!X3.0新增】腳本位置：source/plugin/插件目錄/secqaa/.php<?phpclasssecqaa_name{var$version='1.0';//腳本版本號(hào)var$name='name';//驗(yàn)證問答名稱（可填寫語言包項(xiàng)目）var$description='desc';//驗(yàn)證問答說明（可填寫語言包項(xiàng)目）var$copyright='ComsenzInc.';//版權(quán)（可填寫語言包項(xiàng)目）functionmake（&$question）{//返回安全問答的答案和問題（$question為問題，函數(shù)返回值為答案）}}?>驗(yàn)證碼類（Discuz!X2.5新增）腳本位置：source/class/seccode/seccode_name.php語言包位置：source/language/seccode/lang_name.php【Discuz!X3.0新增】腳本位置：source/plugin/插件目錄/seccode/seccode_name.php<?phpclassseccode_name{var$version='1.0';//腳本版本號(hào)var$name='name';//驗(yàn)證碼類型名稱（可填寫語言包項(xiàng)目）var$copyright='ComsenzInc.';//版權(quán)(可填寫語言包項(xiàng)目)var$setting=array();//后臺(tái)設(shè)置后的變量functioncheck($value,$idhash){〃檢查輸入的驗(yàn)證碼，返回true表示通過}functionmake(){〃輸出驗(yàn)證碼，echo輸出內(nèi)容將顯示在頁面中}}?>計(jì)劃任務(wù)模塊開發(fā)?本功能為Discuz!X3.0新增內(nèi)容?計(jì)劃任務(wù)模塊用于拓展一個(gè)計(jì)劃任務(wù)項(xiàng)目，本模塊會(huì)在插件安裝時(shí)自動(dòng)添加到系統(tǒng)計(jì)劃任務(wù)中，并在插件卸載時(shí)自動(dòng)從中刪除腳本位置：source/plugin/插件目錄/cron/cron_name.php<?php//cronname:mycron計(jì)劃任務(wù)名稱，可寫腳本語言包中的項(xiàng)目//week:1設(shè)置星期幾執(zhí)行本任務(wù)，留空為不限制//day:1設(shè)置哪一日?qǐng)?zhí)行本任務(wù)，留空為不限制//hour:1設(shè)置哪一小時(shí)執(zhí)行本任務(wù)，留空為不限制//minute:0,30設(shè)置哪些分鐘執(zhí)行本任務(wù)，至多可以設(shè)置12個(gè)分鐘值，多個(gè)值之間用半角逗號(hào)","隔開，留空為不限制if(!defined('IN_DISCUZ')){exit('AccessDenied');}//您的計(jì)劃任務(wù)腳本內(nèi)容?〉緩存更新模塊開發(fā)?本功能為Discuz!X3.0新增內(nèi)容?緩存更新模塊用于在系統(tǒng)更新緩存時(shí)拓展一個(gè)緩存更新項(xiàng)目腳本位置：source/plugin/插件目錄/cache/.php<?phpif(!defined('IN_DISCUZ')){exit('AccessDenied');}functionbuild_cache_plugin_name(){〃您的緩存更新腳本內(nèi)容}?>插件安裝、卸載、升級(jí)腳本的設(shè)計(jì)目錄［隱藏］?1安裝、卸載2升級(jí)3檢測4授權(quán)協(xié)議、插件介紹5Discuz!版本兼容性設(shè)置6其他論壇數(shù)據(jù)導(dǎo)入7小提示安裝、卸載插件作者可以設(shè)計(jì)2個(gè)腳本文件用于插件的安裝和卸載，文件名任意。腳本中可用runquery()函數(shù)執(zhí)行SQL語句，表名可以直接寫“cdb_”。插件作者只需在導(dǎo)出的XML文件結(jié)尾加上安裝、卸載腳本的文件名即可<itemid="installfile"><![CDATA[install.php]]></item><itemid="uninstallfile"><![CDATA[uninstall.php]]></item></item></root>安裝、卸載程序中可隨意設(shè)計(jì)頁面的跳轉(zhuǎn)，只要在插件安裝、卸載結(jié)束時(shí)候輸出添加以下代碼即可。$finish=TRUE;升級(jí)插件作者可以設(shè)計(jì)一個(gè)腳本文件用于插件的升級(jí)，文件名任意。腳本中可用runquery()函數(shù)執(zhí)行SQL語句，表名可以直接寫“cdb_”。插件作者只需在導(dǎo)出的XML文件結(jié)尾加上升級(jí)腳本的文件名即可<itemid="upgradefile"><![CDATA[upgrade.php]]></item></item></root>升級(jí)程序中可通過$fromversion和$toversion變量判斷升級(jí)的具體版本號(hào)，并隨意設(shè)計(jì)頁面的跳轉(zhuǎn)，只要在插件升級(jí)結(jié)束時(shí)候輸出添加以下代碼即可。$finish=TRUE;插件的當(dāng)前版本號(hào)位于XML文件的以下分支中，可自行更改。<itemid="plugin"><itemid="version"><![CDATA[當(dāng)前版本]]></item></item>檢測插件作者可以設(shè)計(jì)一個(gè)腳本文件用于插件在安裝、卸載、升級(jí)操作前的檢測，文件名任意。插件作者只需在導(dǎo)出的XML文件結(jié)尾加上檢測腳本的文件名即可<itemid="checkfile"><![CDATA[check.php]]></item></item> </root>授權(quán)協(xié)議、插件介紹插件在安裝的時(shí)候您可以自定義授權(quán)信息文本，文本支持Discuz!代碼，站長同意后才能安裝插件。如果插件存在后臺(tái)管理界面或者變量配置，那么插件介紹文本會(huì)顯示在插件后臺(tái)頁面中。插件作者只需在導(dǎo)出的XML文件結(jié)尾加上以下內(nèi)容即可<itemid="license"><![CDATA[授權(quán)協(xié)議文本]]></item><itemid="intro"><![CDATA[插件介紹文本]]></item></item> </root>Discuz!版本兼容性設(shè)置請(qǐng)仔細(xì)檢查您的插件是否可以在相應(yīng)的Discuz!版本中運(yùn)行。然后在XML文件的以下分支中自行更改。如您的插件兼容多個(gè)版本，請(qǐng)用逗號(hào)■(,)分隔，如“X2,X2.5”(此寫法從Discuz!X2R20120329后開始支持)<itemid="Data"><itemid="plugin"></item><itemid="version"><![CDATA[兼容性設(shè)置]]></item></item>其他論壇數(shù)據(jù)導(dǎo)入插件安裝時(shí)可以直接導(dǎo)入一個(gè)或多個(gè)論壇數(shù)據(jù)，這些論壇數(shù)據(jù)包括表情(smilies)、風(fēng)格(styles)的數(shù)據(jù)。在導(dǎo)出的XML文件結(jié)尾加上需要導(dǎo)入數(shù)據(jù)的類型和數(shù)據(jù)文件名即可，多個(gè)文件名用逗號(hào)(",”)分隔。<itemid="importfile"><itemid="smilies"><![CDATA[discuz_smilies_test.xml]]></item><itemid="styles"><![CDATA[discuz_styles_test.xml]]></item></item></item> </root>小提示如果導(dǎo)出的XML文件名以SC_GBK、SC_UTF8、TC_BIG5、TC_UTF8結(jié)尾，顯示的時(shí)候?qū)⒅苯语@示為“簡體”、“繁體”、“UTF8”等字樣。插件模板和語言包的設(shè)計(jì)插件語言包創(chuàng)建語言包給插件創(chuàng)建語言包首先需要?jiǎng)?chuàng)建一個(gè)data/plugindata/identifier.lang.php文件，文件內(nèi)容中包含4個(gè)數(shù)組，如下：<?php$scriptlang['identifier']=array('english'=>'chinese',...);$templatelang['identifier']=array('english'=>'chinese',...);$installlang['identifier']=array('english'=>'Chinese',...);$systemlang['identifier']=array('file'=>array('english'=>'Chinese',...),...);?>$scriptlang為程序腳本文件的語言包。$templatelang為模版文件的語言包。$installlang為安裝、升級(jí)、卸載腳本用的語言包。$systemlang為系統(tǒng)語言包(Discuz!X3新增)。如果插件不涉及某些類型的語言文字，變量可忽略。然后在插件基本設(shè)置中開啟語言包選項(xiàng)后即可。調(diào)用語言包模版中調(diào)用模板文件語言包，通過｛langidentifierenglish｝方式調(diào)用。程序腳本中調(diào)用腳本文件語言包，通過lang('plugin/identifier；'english')方式調(diào)用。安裝腳本中調(diào)用安裝腳本文件語言包，通過$installlang變量直接獲取。如$installlang['english']。系統(tǒng)語言包用于替換系統(tǒng)語言包中的某些語言條目。語言包導(dǎo)出創(chuàng)建好的語言包在插件導(dǎo)出后會(huì)自動(dòng)導(dǎo)出到XML文件中，供插件作者轉(zhuǎn)碼后發(fā)放多編碼版本的插件。如上例中導(dǎo)出的XML中會(huì)包含以下內(nèi)容:<itemid="language"><itemid="scriptlang"><itemid="english"><![CDATA[chinese]]></item></item><itemid="templatelang"><itemid="english"><![CDATA[chinese]]></item></item><itemid="installlang"><itemid="english"><![CDATA[chinese]]></item></item><itemid="systemlang"><itemid="file"><itemid="english"><![CDATA[chinese]]></item></item></item></item>data/plugindata/identifierlang.php文件不必在插件發(fā)布的時(shí)候?qū)С?，此文件僅供插件設(shè)計(jì)者模式時(shí)使用。插件模板插件的模板統(tǒng)一放置到source/plugin/identifie/template目錄下，程序腳本通過以下語句調(diào)用插件模板文件，如下例，調(diào)用source/plugin/identifie/template/test.htmincludetemplate('identifier:test');模版中調(diào)用插件模版通過以下方法