Installing contributed modules or plugins

2008-07-27T13:27:13Z

Ghanson: /* Module/plugin installation */

''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:

* [http://moodle.org/mod/data/view.php?id=6009 the Modules and plugins database] or
* [http://cvs.sourceforge.net/viewcvs.py/moodle/contrib/ cvs:moodle/contrib] using the URL <nowiki>http://download.moodle.org/download.php/modules/directory_name.zip</nowiki>

==Module/plugin installation==
To install a contributed module or plugin:
# Download the zip file and unzip it to your ''moodle/mod'' directory. Please note that some modules and plugins may require to be installed to a different destination. For instance the "plugin" question types (i.e. those which are not part of Moodle regular distribution) need to be installed to your ''moodle/question/type'' directory, and blocks need to be installed to your ''moodle/blocks'' directory.
# Some of the modules may contain their own language files. If so then just leave them there, they'll be found automatically. Note however, that if you try to edit any of the module's language strings using the ''Site Administration > Language'' editing interface, such language files will not be found.
# Visit your admin page <nowiki>http://your_moodle_address/admin/index.php</nowiki> to complete the installation.

===To install a contributed module to a local Mac OS X web server===

Download the zip file and unzip it to:
/Applications/MAMP/htdocs/moodle19/mod
Visit your Local Moodle site <nowiki>http://localhost:8888/moodle19/</nowiki>
Site Administration
Notifications
Scroll to the bottom of the page and click on "Continue"
Check your new module has been installed:
Site Administration
Modules
Activities
Manage activities

==Module and block removal==
To remove a contributed module:
# Access ''Administration > Modules > Activities > Manage activities'' (or ''Administration > Modules > Activities'' in versions of Moodle prior to 1.9).
# Click on delete next to the module you wish to remove.
# Use a file manager to remove/delete the actual module directory from ''moodle/mod'', otherwise Moodle will reinstall it next time you access the site administration.

To remove a contributed block:
# Access ''Administration > Modules > Blocks > Manage blocks'' (or ''Administration > Modules > Blocks'' in versions of Moodle prior to 1.9).
# Click on delete next to the block you wish to remove.
# Use a file manager to remove/delete the actual module directory from ''moodle/blocks'', otherwise Moodle will reinstall it next time you access the site administration.

==See also==

*Using Moodle [http://moodle.org/mod/forum/view.php?id=44 Activity modules forum] and [http://moodle.org/mod/forum/view.php?id=2121 Blocks forum]
*[http://www.youtube.com/watch?v=pPUB_ReBPeg Installing contributed modules in Moodle video]
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=58212 Please help - Cannot get additional blocks to install] forum discussion

[[Category:Contributed code]]
[[Category:Installation]]

MoodleDocs - User contributions [en]

Installing contributed modules or plugins