安装插件

来自MoodleDocs
跳转至:导航、​搜索

附加组件是一种可选的插件,可以为Moodle增加额外的特性及功能,如新的活动,新的测验问题类型,新的报告,或与其他系统进行整合等等。

“插件”和“附加组件”是什么意思?

Moodle = 核心代码 + 插件

插件可以是标准的插件(通过Moodle软件包一起下载的插件为标准插件),也可以是附加组件。

生产站点的注意事项(如果只是使用Moodle请跳过这一步)

非常重要的警告:请注意一些附加组件并没有被审阅过,他们的质量或(及)适应性是否适合你的Moodle站点也没有被检查过。请小心使用。他们可能达不到你的期望,也可能有安全问题,甚至根本不能正常运行。这就是为什么需要完善随着时间推移不断发展的新插件目录系统。

  • 如果你的生产站点比较庞大,考虑一下你真的需要用到插件吗?更多的功能意味着更多的支持,(潜在)更多的错误,升级的时候需要担心更多的东西。
  • 插件能获得支持或维护吗?如若出了问题能否找到支持?有人修复Bug吗?
  • 如若插件在Moodle以后的版本不能用了,你怎么办?
  • 留意补丁其他类型的插件目录)!如果插件被修改或替换了核心文件,那么就要当心了。插件只能在创建它时的Moodle确切版本下才能正常工作,插件极有可能不会在Moodle升级后还存活下来。

安装附加组件

为安装插件,其源码必须部署在Moodle安装目录下合适的位置,还需要访问管理主页管理>网站管理>通告。有3种方法可以部署插件代码。

Moodle 2.5及以上版本,插件可以从Moodle内部部署,或者直接从插件目录上传压缩文件。Web服务器必须要有插件目录文件夹的可写权限以使新插件可以通过这些方法中的一个进行安装。

除此之外,插件源码也可以在服务器手动部署。

直接在插件目录进行安装

  1. 以管理员身份登录,访问管理>网站管理>插件>安装插件
  2. 点击按钮“从Moodle插件目录安装插件”。
  3. 使用安装按钮进行搜索插件,点击安装按钮然后点击继续。
  4. 核验是否收到“验证通过!”的信息,然后点击“安装插件”按钮。

通过上传的ZIP文件进行安装

  1. 访问Moodle插件目录页面,选择你站点当前的Moodle版本,然后选择一个插件并点击下载按钮进行ZIP文件的下载。
  2. 以管理员身份登录,访问管理>网站管理>插件>安装插件
  3. 上传ZIP文件,选择合适的插件类型,勾选确认复选框,然后点击按钮“从ZIP文件安装插件”。
  4. 核验是否收到“验证通过!”的信息,然后点击“安装插件”按钮。

安装附加组件

对于上述两种方法,点击按钮“安装插件”之后,页面会自动跳转到设置>网站管理>通告,然后安装进程(如,创建必要的数据库等等)会开始进行。

在服务器手动安装

如果不能通过Web管理界面部署插件源码,那么必须手动复制源码到服务器的文件系统(如,当你没有Web服务器Moodle安装目录的可写权限时)。

首先,为插件类型在Moodle源码目录下建立正确的位置。通常位置在:

  • /path/to/moodle/theme/ —— 主题
  • /path/to/moodle/mod/ —— 活动模块及资源
  • /path/to/moodle/blocks/ —— 侧边栏
  • /path/to/moodle/question/type/ —— 问题类型
  • /path/to/moodle/course/format/ —— 课程格式
  • /path/to/moodle/admin/report/ —— 管理报告

访问dev:插件以参阅完整的插件列表及他们在Moodle目录下的位置。

  1. 访问Moodle插件目录页面,选择你站点当前的Moodle版本,然后选择一个插件并点击下载按钮进行下载ZIP文件。
  2. 将ZIP文件上传或复制到Moodle服务器。
  3. 根据插件类型解压ZIP文件到正确的地方(或根据插件说明来做)。
  4. 以管理员帐号登录后,访问设置>网站管理>通告(对大多数插件类型而言,会得到一条说插件已安装的消息通知)。

注意:插件可能包含语言文件。Moodle可以自动探测出他们。使用标准的设置>网站管理>语言编辑界面可以对这些语言字符串进行定制化操作。如若在编辑语言文件出现“数据库错误”的提示则很有可能是下载的插件内的语言文件有编码问题。如若删除含有语言字符串的“plugin_name/lang/other_language_different_to_English/”文件夹后,错误消失了,那么可以确定是语言文件有问题。请告知插件维护人员以使插件在未来的版本可以得到修复。

疑难解答

错误

如果出现错误,请打开调试模式以获得关于引起错误原因的额外信息。

tool_installaddon/err_curl_exec - cURL error 60
这个信息表明了错误是由远程服务器站点SSL证书认证引起的问题。运行在Win7服务器上的Moodle会出现这种问题。参见moodle.org的SSL认证文档获取更多相关信息及可能的解决方案。

出现文件权限错误

安装插件后,接着创建、保存并部署模块实例时会出现的一个常见错误是“出现一个文件权限错误。请检查脚本及所在目录的权限后重试”。如果看到这条错 误信息,那么插件目录的文件权限很可能被设置为711使得不能正常运行。通过FTP客户端或虚拟主机控制面板对安装模块的文件夹及文件进行文件权限设置, 如,设置/moodle/mod/[myplugin]/ 为755,然后查看是否可以正常访问模块实例。

如果是手动安装

  • 检查文件权限。Web服务器需要读取插件文件。如果Moodle其他功能正常运行,那么试着让插件权限与所有权相匹配。
  • 是否能确定地把插件解压或安装在正确的地方?
  • 因为Moodle会浏览插件文件夹以搜寻新的插件,所以插件目录内不能有任何其他文件或文件夹。确保已经删除了压缩包,也不要尝试着把旧版本的插件重命名为(举例)其他名字——这样还是会崩溃的。
  • 确保插件目录名是对的。所有文件名必须相匹配。所有名称必须相匹配。如若改变文件名,插件则不能正常工作。

获得帮助

使用Moodle讨论区的合适版块询问。务必要描述清楚你的问题(包括MySLQ、PHP的版本等)及为此做过什么,出现了什么情况。粘贴并复制所有错误信息。提供下载插件的具体链接(很多插件名是相似的)。

卸载插件

如需卸载插件:

  1. 访问管理>网站管理>插件>插件概览,然后点击欲移除插件相对应的卸载按钮;
  2. 按照指示使用文件管理器移除/删除对应的插件目录,否则下次访问管理界面时插件会重新安装。

插件概览


插件概览高亮了检查可用更新按钮

管理>网站管理>插件>插件概览内的插件概览页面列出了所有已安装的插件,并说明了插件的版本号,是否已发布(2.7新功能),可用性(启用或禁用)及设置链接(如果有的话)。

按钮“检查可用更新”使得管理员可以快速检查安装在Moodle站点上的标准插件或附加组件(从插件目录得知)是否有可用更新。任何可用更新都会高亮显示,并附有进一步的信息及与插件相对应的备注栏里的下载链接。

从Moodle内部更新插件

Moodle2.4版本及以上,管理员可以通过管理>网站管理>服务器>更新通知启用更新部署。每当有可用更新,“安装这个更新”的按钮就会显示在插件概览页面。参见自动更新部署以获取更多信息。

避免从Moodle内部安装插件

如有需要,从config-dist.php粘贴如下代码到config.php可以防止从Moodle内部安装及升级插件:
// Use the following flag to completely disable the On-click add-on installation
// feature and hide it from the server administration UI.
//
// $CFG->disableonclickaddoninstall = true;

另请参阅

为开发人员: