iWebSNS插件规范（beta版）.PDF

iWebSNS插件规范(beta版) 插件简介 插件就是为了满足个性化需求按照 iWebSNS 插件开发规范编写的可插拔程序，虽然可以直 接对 iWebSNS 进行二次开发实现插件同样的功能，但是这样做势必影响到系统的升级和稳 定性。采用插件的方式，可以随时进行停用和卸载，而且对系统毫无影响。 插件的类型 插件显示位置和分布如下。 插件规范及注意：我们这里以插件的标识符 myplugin （建议唯一）为例说明。 1、myplugin 应该放在 plugins 目录下面； 2、myplugin 必需包含 plugin.xml 文件，此文件用来配制插件的基本信息，可以通过工具自 动生成； 3、如果插件有复杂的交互功能，还需在 myplugin 目录下创建 actions.xml 文件，并且编写相 应的脚本文件。 插件开发步骤: 1、明确自己需要的功能，先认真看清楚 iWebSNS 是否已经包含； 2、插件命名（中英文皆可）。插件的标识符（必需为英文）建议唯一，这点非常重要，建议 在开发插件的时候一定要遵守下面的规范； 3、明确插件要显示的位置（参见上面的图示），以确定插件的类型。 插件的分类有： 1）、以嵌入的方式来显示，交互主要是通过 Ajax 来实现。此类插件为系统的 Widget 插件； 2）、通过页面的主显区域显示，实现较为复杂的交互功能。此类插件为系统的 APP 应 用； 3)、在两者之间，部分嵌入页面，部分显示在主显区域，即系统的 APP+Widget 插件。 4、如果开发需要有 API 的支持，请参阅 API 文档。 5、编写开发完成后，生成自己的 Plugin.xml 插件的安装信息文件。此文件的创建由 createplugin.php 文件生成，该文件可从官方下载，或者运行系统 plugins 目录下的 createplugin.php 文件生成，如果插件涉及到交互脚本，还需要创建自己的 Actions.xml 文件， 下面会有详细的介绍 Actions.xml 的编写规范。 6、开发的插件如果涉及到数据表的操作，则应该先创建好自己的数据表，然后用 phpmyadmin、SQLyog 导出，如果自己编写一定要遵守 SQL 文件的编写规范,并把些文件配 制到 plugin.xml 中。 7、调试通过后，插件即可发布。 关于 actions.xml 文件编写： 格式如下： ?xml version=1.0 encoding=UTF-8? !DOCTYPE actions SYSTEM ../Actions.dtd//此行一定要引入，否则程序不能正常运行 actions package name=test action name=show file=action/PersonAction.php class=Person method=show return name=inputerror.php/return return name=successview/helloword_list.php/return /action action name=add file=action/PersonAction.php method=add return name=inputerror.php/return return name=successview/helloword_list.php/return /action action name=de