编辑“HDWiki/插件开发指南”

{{HDWiki top}}
==插件简介==
[[插件]]就是为了满足个性化需求按照[[HDwiki]]插件开发规范编写的可插拔程序，虽然可以直接对HDwiki进行[[二次开发]]实现插件同样的功能，但是这样做势必影响到系统的升级和稳定性。

采用插件的方式，可以随时进行停用和卸载，而且对系统毫无影响。

==插件的类型==
插件按照是否需要在前台显示，可以分为两类：前台展示类插件和非前台展示类插件。

插件举例：

1、百科联盟插件：只需要系统具有联盟同步和导入数据的功能，不需要在前台产生单独的频道，所以是非前台展示类插件。

2、互动摸摸插件：只需要后台管理，也是非前台展示类插件。

3、许愿墙插件：需要在前台展示内容，所以是前台展示类插件。

4、[[UCenter]]插件：非前台展示类插件。

目前的大部分插件都是非前台展示类，前台展示类插件开发起来应该是更有意思，比方说你可以开发一个类似开心网的争车位的插件，这类插件可玩性强。
 
导数据和数据采集等不需要在前台有专门的入口，所以都是非前台展示类插件。

==插件规范==
注意，我们这里设定插件的唯一标识符为myplugin 。
*myplugin应该放在 plugins 目录下面。
*myplugin是采用MVC的开发模式。
*myplugin包含有3个子目录 ：control、model、view
*myplugin子目录model下面必须有一个文件叫做：myplugin.class.php
*myplugin.class.php 这个文件的内容如下：
<pre>
!defined('IN_HDwiki') && exit('Access Denied');

class mypluginmodel {

    var $db;
    var $base;

    function mypluginmodel(&$base) {
        $this->base = $base;
        $this->db = $base->db;
    }
    
    function install(){
        $plugin=array(
            'name'=>'我的插件',                //插件的名称
            'identifier'=>'myplugin',            //插件的唯一标识符
            'description'=>'这个插件是用来测试的',        //插件的描述
            'datatables'=>'',            //插件用到的数据库表，多个表用逗号分隔
            'type'=>'0',                     //插件的类型，1为前台展示型，0为非前台展示型
            'copyright'=>'lovewiki',         //插件的作者
            'homepage'=>'http://kaiyuan.hudong.com',  //插件的官方网址
            'version'=>'1.0',           //插件的版本号
            'suit'=>'4.0.4',               //适合运行的HDwiki版本号
            'modules'=>''                 //卸载需要填写的信息，暂时可以不填写任何东西
        );
        $plugin['vars']=array();
        $plugin['hooks']=array();
        return $plugin;
    }

    function uninstall(){
    
    }
}    

?>
</pre>
6、myplugin子目录control下面必须有一个文件叫做：admin_myplugin.php

7、admin_myplugin.php 这个文件的内容如下：
<pre>
!defined('IN_HDwiki') && exit('Access Denied');
 
class control extends base{

    function control(& $get,& $post){
        $this->base( & $get,& $post);
        $this->load('plugin');
        $this->loadplugin('myplugin');
        $this->view->setlang('zh','back');
    }

    function dodefault() {
        echo 'nothing!';
    }

}

?>
</pre>

==插件开发步骤==
1、明确自己需要的功能，先认真看清楚HDwiki是否已经包含。

2、给插件想好名称（中英文都可）。给插件想好唯一标识符，也就是英文名称，这个非常重要。

3、把插件开发向导 pluginwizard.php 这个工具放到HDwiki的根目录下面。

4、假定你的HDwiki网址为：<nowiki>http://www.mydomain.com</nowiki>,在[[浏览器]]打开地址,<nowiki>http://www.mydomain.com/pluginwizard.php</nowiki>，然后按照提示，填入相关的信息，最后点击生成即可。

5、到后台HDwiki插件下，点击全部推荐插件，即可看到插件列表，这个时候只需要点击按钮“安装此插件”即可完成插件的安装。

6、至此，插件的开发和调试环境已经完成，我们只需要增加相应的方法和模板文件即可完成插件的编写。

7、插件开发完毕后，我们进入已安装插件列表，点击“分享”即可把我们的插件发布到HDwiki官方网站，从而完成插件的共享和传播。

==参考来源==
http://kaiyuan.hudong.com/

{{HDWIKI}}

[[category:HDWiki|C]]