Discuz教程网

[插件制作] Discuz 插件的安装、卸载和升级XML制作方法

[复制链接]
authicon dly 发表于 2012-9-11 22:57:22 | 显示全部楼层 |阅读模式
一、安装、卸载
插件作者可以设计 2 个脚本文件用于插件的安装和卸载,文件名任意。脚本中可用 runquery() 函数执行 SQL 语句,表名可以直接写“cdb_”。插件作者只需在导出的 XML 文件结尾加上安装、卸载脚本的文件名即可
  1. <item id="installfile"><![CDATA[install.php]]></item>
  2. <item id="uninstallfile"><![CDATA[uninstall.php]]></item>
  3. </item>
  4. </root>
复制代码

安装、卸载程序中可随意设计页面的跳转,只要在插件安装、卸载结束时候输出添加以下代码即可。
  1. $finish = TRUE;
复制代码

二、升级
插件作者可以设计一个脚本文件用于插件的升级,文件名任意。脚本中可用 runquery() 函数执行 SQL 语句,表名可以直接写“cdb_”。插件作者只需在导出的 XML 文件结尾加上升级脚本的文件名即可
  1. <item id="upgradefile"><![CDATA[upgrade.php]]></item>
  2. </item>
  3. </root>
复制代码

升级程序中可通过 $fromversion 和 $toversion 变量判断升级的具体版本号,并随意设计页面的跳转,只要在插件升级结束时候输出添加以下代码即可。
  1. $finish = TRUE;
复制代码

插件的当前版本号位于 XML 文件的以下分支中,可自行更改。
  1. <item id="plugin">
  2. ......
  3. <item id="version"><![CDATA[当前版本]]></item>
  4. ......
  5. </item>
复制代码

三、检测
插件作者可以设计一个脚本文件用于插件在安装、卸载、升级操作前的检测,文件名任意。插件作者只需在导出的 XML 文件结尾加上检测脚本的文件名即可
  1. <item id="checkfile"><![CDATA[check.php]]></item>
  2. </item>
  3. </root>
复制代码

四、授权协议、插件介绍
插件在安装的时候您可以自定义授权信息文本,文本支持 Discuz! 代码,站长同意后才能安装插件。如果插件存在后台管理界面或者变量配置,那么插件介绍文本会显示在插件后台页面中。插件作者只需在导出的 XML 文件结尾加上以下内容即可
  1. <item id="license"><![CDATA[授权协议文本]]></item>
  2. <item id="intro"><![CDATA[插件介绍文本]]></item>
  3. </item>
  4. </root>
复制代码

五、Discuz! 版本兼容性设置
请仔细检查您的插件是否可以在相应的 Discuz! 版本中运行。然后在 XML 文件的以下分支中自行更改。

如您的插件兼容多个版本,请用逗号(,)分隔,如“X2,X2.5”(此写法从 Discuz! X2 R20120329 后开始支持)
  1. <item id="Data">
  2. <item id="plugin">
  3. ......
  4. </item>
  5. ......
  6. <item id="version"><![CDATA[兼容性设置]]></item>
  7. ......
  8. </item>
复制代码

六、其他论坛数据导入
插件安装时可以直接导入一个或多个论坛数据,这些论坛数据包括表情(smilies)、风格(styles)的数据。在导出的 XML 文件结尾加上需要导入数据的类型和数据文件名即可,多个文件名用逗号(",")分隔。
  1. <item id="importfile">
  2. <item id="smilies"><![CDATA[discuz_smilies_test.xml]]></item>
  3. <item id="styles"><![CDATA[discuz_styles_test.xml]]></item>
  4. </item>
  5. </item>
  6. </root>
复制代码

七、小提示
如果导出的 XML 文件名以 SC_GBK、SC_UTF8、TC_BIG5、TC_UTF8 结尾,显示的时候将直接显示为“简体”、“繁体”、“UTF8”等字样。

相关阅读:
1、Discuz插件程序和模板语言包制作方法
2、Discuz!插件的通过数据库读取和缓存读取获取插件信息和参数
3、Discuz插件页面嵌入类型脚本格式
4、Discuz插件接口、插件模块和插件变量配置
5、编写Discuz!X3插件需要仔细注意的一些原则



上一篇:Discuz插件程序和模板语言包制作方法
下一篇:Discuz 任务、道具、任务和验证类插件制作
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

1314学习网 ( 浙ICP备10214163号 )

GMT+8, 2025-5-2 01:25

Powered by Discuz! X3.4

© 2001-2013 Comsenz Inc.

快速回复 返回顶部 返回列表