Moodle_函数和模块功能说明书_V2_3_1_-范例与格式-20121127.docVIP

关键函数和模组功能说明书 文件标识 关键函数和模组功能说明书 当前版本 版本v1.0 撰写 完成日期 版本历史 版本 / 状态 撰写 起止日期 备注 版本1.0/完成撰写 2012-11/2012- 目 录 1. 引言 1 2. 常用的通用API 2 2.1. 访问权限API 2 2.2. 数据操作API 6 2.3. 文件API 23 2.4. 表单 API 28 2.5. 日志API 30 2.6. 导航API 32 2.7. 页面API 34 2.8. 输出API 41 2.9. 字符串API 60 2.10. 升级API 68 3. 关键模组功能 70 3.1. Assign 70 3.2. Assignment 70 3.3. Book 71 3.4. Chat 71 3.5. Choice 72 3.6. Data 72 3.7. Feedback 73 3.8. Folder 73 3.9. Forum 73 3.10. Glossary 74 3.11. Imscp 74 3.12. Label 75 3.13. Lesson 75 3.14. Lti 75 3.15. Page 76 3.16. Quiz 76 3.17. Resource 76 3.18. Scorm 77 3.19. Survey 77 3.20. url 78 3.21. wiki 78 3.22. workshop 78 4. 配置参数详细说明 80 引言 Moodle网络教学平台支持多样化的教学方式，可以为学习者的自主学习、协作学习及个性化学习创造一个良好的网络学习环境，目前已经在世界上很多国家和地区得到广泛的应用，并且取得很好的教学效果。但随着互联网进入Web2．0时代，大量计算机新技术、新应用不断涌现，这对于网络课程的开发也势必要求引入更多新的计算机应用技术，同时这也给基于Moodle平台的网络课程建设提出了更多新要求。 目前，国内对Moodle平台的研究主要集中在网络课程实现与应用方面的探讨，而对平台自身的技术研究则略显不足。本文将详细的阐述与讲解Moodle（v2.3.1）平台的关键函数和模组功能，对moodle二次开发和网络课程建设及教学实践进行将有很大的价值与意义。关键函数功能说明 常用的通用API 访问权限API 主要功能是判断当前用户权限。同时还允许模块用来扩展Moodle功能。 提取上下文功能 1）context::instance_by_id($contextid) 2）参数说明 参数名 参数说明 contextid 上下文Id 3）返回值：$context 4）函数功能：用于实例化对象，对象将在实例化后被系统自动删除 5）注意事项： 1：如果对象没有被成功创建将抛出异常 2：被删除的用户将不再拥有对象 6）范例： $systemcontext = context_system::instance(); $usercontext = context_user::instance($user-id); $categorycontext = context_coursecat::instance($category-id); $coursecontext = context_course::instance($course-id); $contextmodule = context_module::instance($cm-id); Determining that a user has a given capability has_capability() 1）参数说明 参数名 参数说明 context 当前上下文 User 当前用户 2）返回值：true/false 3）函数功能：检查用户在一个给定的环境下是否拥有一个特定的权限。默认值是检查当前用户的权限。 4）注意事项： 1：默认值是检查当前用户的权限,不过也可以传给这个函数一个其他的用户id,默认的情况下管理员账户将返回true。 5）范例： $context = context_module::instance($cm-id); has_capability(mod/folder:managefiles, $context) require_capability() 1）参数说明 参数名 参数说明 context 当前上下文 User 当前用户 2）返回值：无 3）函数功能：检查用户在一个给定的环境下是否拥有一个特定的权限，当用户没有权限的时候抛出权限控制异常。 4）注意事项： 1：和has_capabilit