1.模块的安装卸载机制介绍

OC的模块安装机制目前来说比较简单，暂时只支持本地模块的安装卸载。

如果要能够被OC识别并允许安装卸载。开发人员需要遵守以下约定。

目录结构约定：

模块文件放置在

/Application下

每一个模块的目录结构如下

以Issue（专辑）模块为例

/Conf  配置文件  config.php  模块配置文件
/Controller  控制器  
    IndexController  模块入口控制器  
    IssueController  模块管理后台控制器
/Info  模块信息  
    info.php  模块信息  
    install.sql  模块安装sql  
    uninstall.sql  模块卸载sql 
/Model  业务模型  
    IssueModle.class.php Issue模块
/Static 静态资源存放  
    /css  
    /js
/View  模板文件  
    /defalut 
    /Index      
         index.html  模块首页模板    
    /Public    
    /Widget      
          ueditormini.html  UeditorMini编辑器小部件模板
/Widget  小部件Widget  
    UeditorMiniWidget.class.php  UeditorMini编辑器小部件控制器

模块的生命周期：

安装模块
使用模块
卸载模块

安装模块

此步骤涉及到/Info/info.php

<?php
return array(
//模块名
'name' => 'Issue',
//别名
'alias' => '专辑',
//版本号
'version' => '1.0.0',
//是否商业模块,1是，0，否
'is_com' => 0,
//是否显示在导航栏内？ 1是，0否 暂时无效，保留项
'show_nav' => 1,
//模块描述
'summary' => '专辑模块，适用于精品内容展示',
//开发者
'developer' => '嘉兴想天信息科技有限公司',
//开发者网站
'website' => 'http://www.ourstu.com',
//前台入口，可用U函数
'entry' => 'Issue/index/index',
//后台入口
'admin_entry' => 'Admin/Issue/contents',
//zui中的icon-xxx的小图标，此处为icon-th
'icon' => 'th',
//是否允许卸载，核心模块请设为0
'can_uninstall' => 1
);

上面代码定义了专辑模块的模块信息，显示在模块管理中的内容为

可以点击安装按钮执行安装。
安装的过程就是导入/Info/install.sql这个数据表。
安装成功后，左侧模块列表中会多出一个模块。图标就是info.php中的th。链接地址就是Admin/Issue/contents

卸载模块

同时可以通过卸载按钮卸载文件。

卸载模块其实就是执行了uninstall.sql这个操作。

2.模块的开发

OC中多模块的开发实际上和普通的TP模块开发是一致的。这边主要介绍一下OC中的一些机制，这些机制会大大降低开发成本。

模块管理后台的开发

管理后台的开发涉及到几个知识点：

1.管理后台文件的约定

一般来说，我们要求模块的后台文件放置在Issue/Controller/IssueController.class.php这个位置。而不是放置在Admin模块下。

同时命名空间必须是Admin\Controller

有一点要注意的是，虽然我们放置在Issue模块下，但是执行这些代码还是在Admin模块中，这一点是通过映射这个文件实现的。所以大家可以完全等同于把这个文件放到了Admin下。

<?php

namespace Admin\Controller;
use Admin\Builder\AdminConfigBuilder;
use Admin\Builder\AdminListBuilder;
use Admin\Builder\AdminTreeListBuilder;
class IssueController extends AdminController
{
protected $issueModel;
function _initialize()
{
$this->issueModel = D('Issue/Issue');
parent::_initialize();
}
public function config()
{
$admin_config = new AdminConfigBuilder();
$data = $admin_config->handleConfig();
$admin_config->title('专辑基本设置')
->keyBool('NEED_VERIFY', '投稿是否需要审核','默认无需审核')
->buttonSubmit('', '保存')->data($data);
$admin_config->display();
}
public function issue()
{
//显示页面
$builder = new AdminTreeListBuilder();
$attr['class'] = 'btn ajax-post';
$attr['target-form'] = 'ids';
$attr1 = $attr;
$attr1['url'] = $builder->addUrlParam(U('setWeiboTop'), array('top' => 1));
$attr0 = $attr;
$attr0['url'] = $builder->addUrlParam(U('setWeiboTop'), array('top' => 0));
$tree = D('Issue/Issue')->getTree(0, 'id,title,sort,pid,status');
$builder->title('专辑管理')
->buttonNew(U('Issue/add'))
->data($tree)
->display();
}
}

2.管理后台菜单的创建

模块在被安装之后，会自动在左侧菜单创建一个入口（要求模块的配置信息中admin_entry不为空），这个入口是不需要菜单机制配合的。系统会自动添加。