Moodle Local 插件讲解

Moodle Local 插件讲解

---

Local插件在Moodle中相比于其余插件算是比较容易上手的一个插件，Local插件中先后台分离，不用遨游在杂糅先后端的代码里。学会Local插件是上手其余插件的前提，其实一旦学会Local插件也会发现其余插件不过是它的一种变种形式罢了，只要触类旁通就能很快掌握。

流程图

前端

Template

服务器配置了相应的url，因此每一个插件的加载首页都是index.php，可是并不意味着页面的代码就在 index.php中，首先在index.php中调用renderer.php中相应的页面渲染方法，例如 render_index_page($page)方法：

public function render_index_page($page) {
$data = $page->export_for_template($this);
    render_from_template('local_xxx/index', $data)
}

• 在这个方法中，首先调用了index_page这个类中的export_for_template方法，得到页面静态加载须要的数据，例如mustache模板须要的数据data数组的索引与模板名称一一对应，例如mustache文件中如有 {{#user}} hello !{{/user}}，那么对应class必定存在$data['user'] = xxxx；

• 以render_from_template('local_xxx/index', $data) 为例，local_xxx/index，template目录下一定有文件名为index.mustache的文件，这是moodle封装好的命名规范，而mustache文件就是页面展现的代码所在了；

• 经过{{#js}} require xxx {{/js}} 引入对应的JavaScript文件；

CSS

每一个local插件中都存在一个style.css这样的一个css样式文件，系统运行时，会将每一个模块的css文件内容合并到一块儿，因此若是有两个名称同样的css，则会发生覆盖的现象，因此建议起名字统一在最前面加上当前的插件名称，要注意的是，每次新增、修改或者删除css文件内容后，如若须要当即查看效果，必要以admin角色进入系统，而后清空缓存；

JavaScript

目前系统中的js是基于RequireJS框架，遵循AMD开发规范，利用Grunt构建的。amd目录下有src目录和build目录，src下的xxx.js是供开发时编写调试使用，而build目录下的min.js则是网站实际运行时所使用的js文件，通过压缩能够大幅度提高运行速度。因此每次修改js完毕后，提交代码切勿忘记生成对应的 min.js文件并提供，生成命令为grunt uglify；

后端

db

1. access.php

主要负责记录权限的配置；

2. service.php

负责接收 ajax 提交，配置对应的后台 API 的类名、路径 和方法名等信息，并将对应的ajax方法存入数据库中；

3. install.xml

用于安装系统时表结构的对应生成；

4. install.php

用于安装系统时数据库的缺省数据的提供；

5. upgrade.php 开发规范

用于系统表结构变化等版本升级事项的实现，因为生产环境中客户已有大量数据存在于数据库中，因此这时候不能采起重装系统的方式更改表结构或者更改数据库等操做，这时候就得借助 upgrade.php平滑升级。

后台 API

1. externallib.php

负责编写service.php中ajax提交方法对应的后台方法，并调用lib.php中的API实现；

2. lib.php

负责方法的具体实现，代码与数据库的数据交互

3. lang/en/xxx.php 和 lang/zh_cn/xxx.php

en目录下的表示英文翻译语言文件，zh_cn目录下的表示中文翻译语言文件，具体调用方法为：

• php中： get_string(字符串名, 插件名)

• mustache中： {{#str}}字符串名, 插件名{{/str}}

做者：Tony

2017年02月28日