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 系統：【插件機制】-【裝/升級/卸載】詳解