Discuz X 系統：【外掛機制】-【裝/升級/解除安裝】詳解

安裝、解除安裝、升級

安裝、解除安裝

外掛作者可以設計 2 個指令碼檔案用於外掛的安裝和解除安裝，檔名任意。指令碼中可用 runquery() 函式執行 SQL 語句，表名可以直接寫「cdb_」。外掛作者只需在匯出的 XML 檔案結尾加上安裝、解除安裝指令碼的檔名即可

    		<item id="installfile"><![CDATA[install.php]]></item>
    		<item id="uninstallfile"><![CDATA[uninstall.php]]></item>
    	</item>
    </root>

安裝、解除安裝程式中可隨意設計頁面的跳轉，只要在外掛安裝、解除安裝結束時候輸出新增以下程式碼即可。

$finish = TRUE;

升級

外掛作者可以設計一個指令碼檔案用於外掛的升級，檔名任意。指令碼中可用 runquery() 函式執行 SQL 語句，表名可以直接寫「cdb_」。外掛作者只需在匯出的 XML 檔案結尾加上升級指令碼的檔名即可

    		<item id="upgradefile"><![CDATA[upgrade.php]]></item>
    	</item>
    </root>

升級程式中可透過 $fromversion 和 $toversion 變數判斷升級的具體版本號，並隨意設計頁面的跳轉，只要在外掛升級結束時候輸出新增以下程式碼即可。

$finish = TRUE;

外掛的當前版本號位於 XML 檔案的以下分支中，可自行更改。

    	<item id="plugin">
    		......
    		<item id="version"><![CDATA[當前版本]]></item>
    		......
    	</item>

檢測

外掛作者可以設計一個指令碼檔案用於外掛在安裝、解除安裝、升級操作前的檢測，檔名任意。外掛作者只需在匯出的 XML 檔案結尾加上檢測指令碼的檔名即可

    		<item id="checkfile"><![CDATA[check.php]]></item>
    	</item>
    </root>

授權協議、外掛介紹

外掛在安裝的時候您可以自定義授權資訊文字，文字支援 Discuz! 程式碼，站長同意後才能安裝外掛。如果外掛存在後臺管理介面或者變數配置，那麼外掛介紹文字會顯示在外掛後臺頁面中。外掛作者只需在匯出的 XML 檔案結尾加上以下內容即可

    		<item id="license"><![CDATA[授權協議文字]]></item>
    		<item id="intro"><![CDATA[外掛介紹文字]]></item>
    	</item>
    </root>

版本相容性設定

請仔細檢查您的外掛是否可以在相應的 Discuz! 版本中執行。然後在 XML 檔案的以下分支中自行更改。

如您的外掛相容多個版本，請用逗號 (,) 分隔，如「X2,X2.5」（此寫法從 Discuz! X2 R20120329 後開始支援）

    	<item id="Data">
    		<item id="plugin">
    		    	......
    		</item>
    		......
    		<item id="version"><![CDATA[相容性設定]]></item>
    		......
    	</item>

其他論壇資料匯入

外掛安裝時可以直接匯入一個或多個論壇資料，這些論壇資料包括表情 (smilies) 、風格 (styles) 的資料。在匯出的 XML 檔案結尾加上需要匯入資料的型別和資料檔名即可，多個檔名用逗號 (",") 分隔。

    		<item id="importfile">
    			<item id="smilies"><![CDATA[discuz_smilies_test.xml]]></item>
    			<item id="styles"><![CDATA[discuz_styles_test.xml]]></item>
    		</item>
    	</item>
    </root>

小提示

如果匯出的 XML 檔名以 SC_GBK 、 SC_UTF8 、 TC_BIG5 、 TC_UTF8 結尾，顯示的時候將直接顯示為「簡體」、「繁體」、「UTF8」等字樣。

Discuz X 系統：【外掛機制】-【裝/升級/解除安裝】詳解