Moodle开发基础1

时间  2019-12-08
标签 moodle 开发 基础 繁體版
原文   原文链接

Moodle做为一个主流的开源网络课程管理系统，以其简单而清晰的使用方式和灵活的扩展空间赢得了多数人的青睐。它解决了大部分信息化学习和课程管理的 共同问题(课程设计、发布、组织、做业、测试、统计、评价等) ,可以不加任何修改就可以进行实际应用。<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com: office: office" />

Moodle数据库模型
Moodle的数据库模型通过几年的发展已经很复杂，为了减小这种复杂关系带来的混乱，它采用了这样的命名方式。如: mdl_course_categories，其中“mdl_”是全部系统表格的前缀，course表明属于course的模块，categroies代 表课程分类表，这样既能够保证清晰的表述，又能够避免不一样模块之间数据表格的重名。能够利用DBDesigner4(一种免费的数据库设计软件,能够从http://fabforce.net/dbdesigner4/下载)将Moodle数据库导出成XML文件，并进行分析。Moodle提供了ADODB数据访问抽象层来进行数据库的访问，因此咱们不须要直接编写访问数据库的代码，只要经过抽象层的方法便可。

Moodle data（Moodle数据）
Moodle数据是用户上传内容的文件存储位置记录，Moodle数据也存储登陆到该系统用户的会话数据(sessions data)，若是基于文件的会话(sessions)正在使用。
Moodle数据在文件夹中的组织结构由用户或课程组成。每门课程有一个文件夹，命名为一个整数值。这个整数值即为这门课程的内部数据库的ID。
Moodle 2.0使用一种全新的组织模式来组织用户上传的文件，这是基于哈希算法。

Moodle主要目录结构
admin：系统管理的代码
包含控制管理用户界面的PHP文件。其中包括一个cron.php：做为批处理进程执行系统维护任务，如消息传递和过程当中备份，同时它也用于处理批量操做
auth：验证用户基本模块及扩展模块
包含全部Moodle的身份验证模块。“auth”目录里每个子目录就是一个身份验证模块。这些认证模块控制建立用户，用户配置文件数据，和用户访问系统权限。
backup：课程备份代码
包含课程备份的核心功能：备份，恢复和导入的课程。
blocks：界面板块基本模块及扩展模块
板块用于显示信息框，能够在Moodle页面的右侧或左侧栏。这是最简单的可扩展的模块设计类型。
course：显示和管理课程的代码
这是Moodle重要的组成部分，Moodle是围绕课程组织的。开发人员最有可能修改或增长课程的格式和报告。定制课程格式，可用于改变课程的布局。
enrol：注册模块
包含全部的Moodle的注册模块。注册模块控制课程级角色分配（注册）的建立和管理。
files：显示和管理上传文件的代码
该文件组件控制文件的上传，访问控制，并查看文件。文件管理在Moodle2.0中改写变化很大。Moodle的2.0将容许外部文件库中的文件存储和使用，如：Alfresco, Box.net, and Google Docs等。
filter：过滤器
过滤器系统是关联从数据库到页面建立用户输入的内容。过滤器匹配和修改页面显示以前。它须要考虑到性能的影响，须要认真制定。
lang：语言模块
包含核心系统的语言字符串。语言字符串映射也都存储在Moodle的数据lang文件夹。不一样语言的对应文本，每一个目录表示一种语言，而且和具体的模块对应。
lib：Moodle的核心代码库
包含的核心系统库函数。当咱们开发和定制模块时，咱们将使用在此文件夹中定义的类和功能。
mod：Moodle的基本模块和扩展模块
包含的活动模块（activity modules），如assignment, quiz, wiki, forum, and lesson模块。学习活动是使用Moodle任何课程的核心功能。活动模块（activity modules）比块（blocks）建立更具挑战性和复杂性，由于它们设计到备份，还原，和存储等级等内容。
my：个人课程
它提供了一个上市的分配给学习者的课程列表，包括即将到来的课程活动的总结。用户也能够添加和删除他或她的门户网站页面上的块。“my”提供了一个很好的位置，以最小的核心变化到Moodle显示自定义信息。例如，咱们利用“my”做为一个定制许多项目的面板位置。
theme：站点的主题包，控制站点的样式
包含了全部的内置的Moodle主题和任何自定义主题。每一个主题都有其本身的文件夹。javascript

 

其它还有：
calendar：维护及显示日历的代码
doc：Moodle的帮助文档
login：登陆及帐号建立代码
pix：站点的图片
user：显示和管理用户
onfig.php包含基本的系统设置,通常在第一次安转时设置
ns tall.php安装站点
vers ion版本控制
index.php站点首页

开发概要详见：http://docs.moodle.org/archive/zh/index.php?title=%E5%BC%80%E5%8F%91:%E6%A6%82%E8%A6%81&variant=zh-cnphp

 

一、2个颇有用的关于path的变量
$CFG->dirroot  指向moodle root folder
$CFG->libdir 指向moodle root folder下的lib folderhtml


例如：若要include moodle_home/lib下的lib library，能够java

Php代码   收藏代码
  1. require_once($CFG->libdir . '/blocklib.php');  

 
optional_param & required_param
这2个是moodle特有的function，用来代替php自身的从$GET, $POST, $COOKIE中获取参数值。
required_param函数则要求必需要所要的参数，而optional_param则不须要必定存在所要的参数。
这两个函数都会验证指定的参数为基础的数据，若是是预期之外的数据经过就会产生错误或警告。（详细描述上网查）
例：mysql

Php代码   收藏代码
  1. $id = optional_param('id', 0, PARAM_INT);  
  2. $name = optional_param('name', '', PARAM_RAW);  

第1个参数是param name，第2个参数是缺省值web

 

二、Moodle的入口点

/index.php: The front page（站点首页）
/login/index.php: The login page（登陆页）
/admin/index.php: The main administration page（管理页）
/course/view.php: A course page（课程页）
/mod/*/view.php: A module page（模块页）
如：http://localhost/course/view.php?id=23

三、设置与安装：config.php & setup.php

全部的入口点php文件的第一行都是算法

C代码   收藏代码
  1. require_once(‘../config.php’)  

 
config.php文件执行在全局变量$CFG里设置的初始参数
$CFG中的信息包括：database数据库，网页的URL，script脚本目录，以及数据存储目录的定义设置。sql


注意：config.php includes /lib/setup.php
setup.php设置全部所需的完整的执行环境的初步方案。这包括定义其余几个重要的全局变量，包括： $SESSION, $COURSE, $THEME, and $db。数据库


Setup.php会根据设置在config.php中定义：创建和链接数据库的设置。
Moodle使用ADOdb来进行数据库操做，Moodle使用的默认数据库是MySQL, 是一个开源的关系数据库系统。为了可使用其余的关系数据库服务器, Moodle使用了ADODB将数据层抽象, 这样Moodle就可使用诸如MS SQL Server、 Oracle等关系型数据库。使用ADOdb你须要include /lib/adodb/adodb.inc.php
setup.php还会inlude一些经常使用的库,还会设置其余一些关键的全局变量，从数据库中加载配置变量，设置了缓存（caching），会话 （sessions），环境变量（environment variables），主题（themes），语言（language），和区域（locales）设置。

四、get_record function
该函数是从database里获取record
    例：api

Php代码   收藏代码
  1. if (! ($course = get_record('course', 'id', $id)) ) {  
  2. error('Invalid course id');  
  3. }  


五、require_login function
该函数是用来检查用户是否已登陆到网站或课程 (有些课程可能设置成不须要login). 若是须要登陆网站，但用户又没有登陆，就重定向到登陆页面。若是用户已经登陆，他正在尝试访问课程，但又没有注册到该课程，那么执行该函数就会将用户重定向到选课注册页面。
例：

Php代码   收藏代码
  1. require_login($course);  


六、在Moodle里的显示函数
输出html header的函数有2个
print_header
print_header_simple


上面函数用于输出html header, 包括主题信息和所要的javascript文件等

例：

Php代码   收藏代码
  1. $PAGE->print_header(get_string('course').': %fullname%', NULL, '', $bodytags)；  

 
输出html body是由course的特定format来处理。首先要先include 该课程的format的php文件。

Php代码   收藏代码
  1. require($CFG->dirroot .'/course/format/'. $course->format .'/ format.php')；  

 
    例如，若是课程使用topics format，就会include /course/format/topics/format.php。
该format.php用于处理特定的course page的输出，包括the blocks and main content。
print_footer函数用于输出footer
例：

Php代码   收藏代码
  1. print_footer(NULL, $course);  

 

七、配置Moodle
Moodle的设置分别处于3个地方：
直接在config.php里hard code。
mdl_config table。能够经过administrative code and interfaces进行控制
mdl_config_plugins table。主要是存储来自各个plugin的设置。能够经过plugin administration来进行控制。
全部的配置信息都存在全局变量$CFG里（plugin的设置则会放在plugin变量里）。


例如：$CFG->theme包含您网站的主题选定的文本名称。
    config.php一开始会调用unset($CFG);来保证在config.php and setup.php以前清除全部的设置。
    在config.php里，包含下列的设置：

Php代码   收藏代码
  1. $CFG->dbtype    = 'mysql';  
  2. $CFG->dbhost    = 'localhost';  
  3. $CFG->dbname    = 'moodle';  
  4. $CFG->dbuser    = 'xxx';  
  5. $CFG->dbpass     = 'xxx';  
  6. $CFG->dbpersist =  false;  
  7. $CFG->prefix    = 'mdl_';  
  8. $CFG->wwwroot   = 'http://xxxx:8080/moodle';  
  9. $CFG->dirroot   = 'E:/develop/Zend/Apache2/htdocs/moodle';  
  10. $CFG->dataroot  = 'E:/develop/Zend/Apache2/htdocs/moodledata';  
  11. $CFG->admin     = 'admin';  
  12. $CFG->directorypermissions = xxx;  // try 02777 on a server in Safe Mode  
  13. $CFG->passwordsaltmain = 'xxxx';  

 
    这是config.php最必须的设置，若是想在config.php里进行更多的设置，则要参看config-dist.php的全部的配置设置，而后修改config.php。


   上述设置你能够直接在config.php里修改。
    除了config.php以外的全部其余设置都存储在database的mdl_config 表and mdl_config_plugins 表里。
    那么moodle什么时候把这些来自database的设置赋给$CFG?


就是在config.php里include了lib/setup.php，setup.php调用了

Php代码   收藏代码
  1. $CFG = get_config();  

           
   来执行。get_config()函数来自/lib/moodlelib.php库文件
   注意：get_config函数不会对于在调用以前已经存在的设置进行覆盖。(will not overwrite any $CFG setting that has already been set)。即它不会覆盖config.php里的设置. 这意味着你能够在config.php里硬编码你但愿的设置，在config.php最后一行include了setup.php，但来自 database的设置若是与config.php里的设置同名，则不会覆盖它。

 
对configuration进行修改是经过set_config函数。该函数会以（name、value、plugin name (optional)）做为参数。若是不使用第三个参数，那么set_confg就会把设置存储在mdl_config 表，若是使用这个参数，则存在mdl_config_plugins表里。


    咱们开发的一般是插件 (modules, blocks, and so on)。在开发过程当中，若是你想添加设置的话，强烈建议使用mdl_config_plugins表来存储，即调用set_config时要用到 plugin name参数。这是由于：设置的name必须惟一。若是你想添加设置到mdl_config表里，那么就有可能该设置的name已经存在，产生冲突。而对 于mdl_config_plugins表，它多了一个”plugin” field，这就使你只要保证该设置的name在该plugin里是惟一的便可。


    注意：plugin的设置则会放在plugin变量里，而不是存在$CFG里。
一般，咱们都是经过administration interfaces来set configuration variables。绝对多数的Moodle configuration variables均可以在Site Administration block （用admin login后的home page会看到它）里进行设置。

 

八、Moodle API
绝大多数的api都放在lib目录下，该目录下的library php的命名方式是
    [function]lib.php
    例如 textlib.php and weblib.php
    几乎全部的核心库是包含的，当您经过config.php加载/lib/setup.php将其列入。

 

最经常使用的library有
•  moodlelib.php
•  weblib.php
•  dmllib.php
•  accesslib.php
•  grouplib.php

 

Moodle还会用到一些开源的library，如
•  PEAR
•  ADOdb
•  YUI
•  XMLDB

 

访问控制，登陆和角色
Access control, logins, and roles Moodle的登陆函数使用PHP的'cookie'的功能设置成当前会话的Cookie。

 

一、六种分配级别权限：
        ·site/global（网站全局）
        ·course category（课程类）
        ·course（课程）
        ·blocks（块）
        ·activities（活动）
        ·user（用户）
        ·front page（首页）

 

Contexts是与定义的context水平相关的系统中的元素，Context定义在/lib/accesslib.php里

Php代码   收藏代码
  1. define('CONTEXT_SYSTEM', 10);  
  2. define('CONTEXT_USER', 30);  
  3. define('CONTEXT_COURSECAT', 40);  
  4. define('CONTEXT_COURSE', 50);  
  5. define('CONTEXT_GROUP', 60);  
  6. define('CONTEXT_MODULE', 70);  
  7. define('CONTEXT_BLOCK', 80);  

“System”context只有一个，其余的则有许多个，如”Course”context,“User”context等。

二、有7个内置的角色（role）
     ·administrator（管理员）：系统管理员拥有任何权限，操做任何课程。
     ·teacher（教师）：教师能够在负责的课程中作任何事，包括更改活动和为学生评分。
     ·non-editing teacher（无编辑权教师）：能够在课程中教授和给学生们打分，可是没法改变活动内容。
     ·student（学生）：可参加一门课程，一般拥有较少的特权。
     ·course creator（课程建立者）：能够建立课程，并能够限制在一个课程类别里。
     ·authenticated user（认证的用户）：任何登陆的用户都有这个角色
     ·guest（访客）：非登陆用户拥有最小的权限，并且一般不能在任何地方输入文本。


     这些role均可以分配给上面的一个或多个context。
    每一个用户能够拥有多个角色，这些角色继承全部适用于从用户访问请求的context级别的权限。
Capabilities are associated with context levels, and are specific access rules that can be granted to roles.
Examples of capabilities are:
    ·moodle/site:manageblocks: Can manage blocks at the site context level
    ·moodle/user:viewdetails: Can view details of a user at the user context level
    ·moodle/course:view: Can view a course at the course context level


   每个capability均可以assign给下列4个访问权限级别（access levels）的其中一个：
    ·Not Set（没有设置）
    ·Allow（容许）
    ·Prohibit（禁止）
    ·Prevent（避免）
   注意：开发者能够经过建立capabilities来控制访问咱们的新功能。


   总结来讲：
     ·Contexts are specific elements in Moodle（Contexts是Moodle中的特定元素）
     ·Roles are associated with all contexts（Roles是与全部的contexts关联的）
     ·Capabilities are assigned to roles in a given context（Capabilities都被分配给特定context下的角色）
     ·Users are assigned to roles in a given context（用户都被分配给特定context下的角色）
      普通系统使用User, Role, Capability就OK了，为何moodle还要加多一个context？
      这是由于同一个user在不一样的context的role不一样，好比在system context，user是admin role，而他在course“foo”里是instructor role（导师角色）

 

三、每一个user role在不一样的context里的capability都不一样。
   获取context对象的函数是get_context_instance()。
例：

Php代码   收藏代码
  1. #获取system context对象  
  2. $context = get_context_instance(CONTEXT_SYSTEM);  
  3.   
  4. #获取当前course的context  
  5. global $COURSE;  
  6. $context = get_context_instance(CONTEXT_COURSE, $COURSE->id);  

 
获取context以后，下列2个函数是用来check当前login的user在该context里是否有所指定的capability。
    ·require_capability测试当前用户的capabilities，看看他们是否在指定context内有指定的capability，若是他们没有，页面就重定向到一个错误页面。
    ·has_capability功能与require_capability相似，但不会重定向到错误页面，而是return true or false
  例：

Php代码   收藏代码
  1. $context = get_context_instance(CONTEXT_SYSTEM);  
  2. require_capability('moodle/site:doanything', $context);  

 
   上面的例子是检查当前用户在system context里是否有'moodle/site:doanything'的capability。
   如何为你的moodle plugin/module自定义capability?
   在plugin/module的root目录下建立一个db目录，而后在db目录下建立一个access.php，该文件用来定义capability。


   下例是在helloworld block里定义一个block/helloworld:view capability，该capability的type是read，该capability是属于system context level里，并设置只有admin role user拥有该capability，其余role没有。
代码以下：

Php代码   收藏代码
  1. <?php  
  2. $block_helloworld_capabilities = array(  
  3.     'block/helloworld:view' => array(  
  4.            'captype' => 'read',  
  5.            'contextlevel' => CONTEXT_SYSTEM,  
  6.            'legacy' => array(  
  7.                   'guest' => CAP_PREVENT,  
  8.                   'student' => CAP_PREVENT,  
  9.                   'teacher' => CAP_PREVENT,  
  10.                   'editingteacher' => CAP_PREVENT,  
  11.                   'coursecreator' => CAP_PREVENT,  
  12.                   'admin' => CAP_ALLOW  
  13.            )  
  14.      )  
  15. );  
  16. ?>  

 
   注意：该capability适用于任何使用了该block的地方。不管你是把该block加到home page，仍是admin page，仍是My Moodle page，仍是course page，该capability都适用。但因为该capability是定义在system context level，只有那些在system context level具备admin role的user才可以看到这个block。

接下来将学习5种类型的Moodle plugin的开发：
·block
·filter
·activity module
·theme
·course format
 

来源：http://www.aieln.com/thread-4899-1-1.html

 

 

来源： http://www.aieln.com/thread-5089-1-1.html

http://justcoding.iteye.com/blog/2004090

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程