Installing plugins

Revision as of 12:40, 8 May 2012 by Tim Hunt (talk | contribs)

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 3.3. Up-to-date documentation for the latest stable version of Moodle is probably available here: Installing plugins.

This page requires updating. Please do so and remove this template when finished.


Warning: Please be aware that some contributed modules and plugins have not been reviewed, and the quality and/or suitability for your Moodle site has not been checked. The modules and plugins may have security problems, data-loss problems, interface problems or just plain not work. Please think carefully about maintenance before relying on contributed code in your production site, as some of this code may not work with future versions of Moodle.


Downloads

Contributed modules and plugins may be downloaded from...:

Installation

To install a contributed plugin:

  1. You must have access to the server containing Moodle. This can be direct access, through a network or to a remote server through Internet with an FTP client, you can't do it from "inside" Moodle itself. (There are many free FTP programs like FileZilla [1] that can be used. If you use FTP, you will need to know [from the server provider] the ID and password and maybe a couple more things. Once it is setup, it's as easy as other file management.)
  2. Locate the plugin in Modules Plugin Directory, find the plugin version that matches your Moodle version and click on version release name (or 'Learn more' link). You will see installation instructions for this plugin type.
  3. Download the zip file and unzip it to the correct directory. The correct directory to use depends on the type of plugin you are trying to install. The plugins database will tell you which directory to use when you download the zip file.
  4. In your browser, go to your Moodle site, login as administrator and choose Site Administration > Notifications > Continue
  5. Perform other plugin-specific actions to enable this plugin (add a block to the page, enable filter, add module to some course, etc.)

Note: The plugin may contain language files. They'll be found by your Moodle automatically. These language strings can be customized using the standard Site Administration > Language editing interface.

Installation trouble-shooting

If you visit the admin page and don't get a message about a new block (or module) being successfully installed then check the following:

  • You unzipped the archive to the proper directory

Module and block removal

To remove a contributed module:

  1. First make sure that you don't use this module in any course
  2. Access Administration > Modules > Activities > Manage activities
  3. Click on delete next to the module you wish to remove.
  4. Use a file manager to remove/delete the actual module directory from mod/ directory, otherwise Moodle will reinstall it next time you access the site administration.

To remove a contributed block:

  1. Access Administration > Modules > Blocks > Manage blocks
  2. Click on delete next to the block you wish to remove.
  3. Use a file manager to remove/delete the actual module directory from blocks/ directory, otherwise Moodle will reinstall it next time you access the site administration.

See also

For developers: