Installing plugins: Difference between revisions
Helen Foster (talk | contribs) (module, block, plugin installation) |
Helen Foster (talk | contribs) (Installation trouble-shooting) |
||
Line 39: | Line 39: | ||
==Plugin installation== | ==Plugin installation== | ||
Plugins are installed in various places in Moodle, depending upon the plugin. For example, plugin question types need to be unzipped to your ''moodle/question/type'' directory. | Plugins are installed in various places in Moodle, depending upon the plugin. For example, plugin question types need to be unzipped to your ''moodle/question/type'' directory. | ||
==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: | |||
# The new block folder is named correctly. For example, the Learning Resources block folder should be named "learning_resources" (not "learning_resources_block"). | |||
# The new block folder is not contained within another folder. For example, unzipping ''block_learning_resources.zip'' results in a folder named "block_learning_resources" containing a folder named "blocks" containing a folder named "learning_resources". If it's easier, just copy and paste the folder named "learning_resources" into the blocks folder of your Moodle site. | |||
If you browse the blocks folder of your Moodle site, you'll notice that all the blocks follow a pattern - the activity_modules folder contains a file ''block_activity_modules.php'', the calendar_month folder contains a file ''block_calendar_month.php'', the learning_resources folder contains a file ''block_learning_resources.php'' etc. Modules follow a similar pattern. | |||
==Module and block removal== | ==Module and block removal== | ||
Line 54: | Line 63: | ||
==See also== | ==See also== | ||
*Using Moodle [http://moodle.org/mod/forum/view.php?id=44 | *Using Moodle [http://moodle.org/mod/forum/view.php?id=44 Contributed modules and plugins forum] | ||
*[http://www.youtube.com/watch?v=pPUB_ReBPeg Installing contributed modules in Moodle video] | *[http://www.youtube.com/watch?v=pPUB_ReBPeg Installing contributed modules in Moodle video] | ||
[[Category:Contributed code]] | [[Category:Contributed code]] | ||
[[Category:Installation]] | [[Category:Installation]] |
Revision as of 17:37, 28 August 2008
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:
- the Modules and plugins database or
- cvs:moodle/contrib using the URL http://download.moodle.org/download.php/modules/directory_name.zip
Module installation
To install a contributed module:
- Download the zip file and unzip it to your moodle/mod directory.
- Visit your admin page http://your_moodle_address/admin/index.php to complete the installation.
Note: The module may contain language files. If so then just leave them in the folder and they'll be found automatically. However, language strings cannot be edited using the Site Administration > Language editing interface.
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 http://localhost:8888/moodle19/
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
Block installation
To install a contributed block:
- Download the zip file and unzip it to your moodle/block directory.
- Visit your admin page http://your_moodle_address/admin/index.php to complete the installation.
Plugin installation
Plugins are installed in various places in Moodle, depending upon the plugin. For example, plugin question types need to be unzipped to your moodle/question/type directory.
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:
- The new block folder is named correctly. For example, the Learning Resources block folder should be named "learning_resources" (not "learning_resources_block").
- The new block folder is not contained within another folder. For example, unzipping block_learning_resources.zip results in a folder named "block_learning_resources" containing a folder named "blocks" containing a folder named "learning_resources". If it's easier, just copy and paste the folder named "learning_resources" into the blocks folder of your Moodle site.
If you browse the blocks folder of your Moodle site, you'll notice that all the blocks follow a pattern - the activity_modules folder contains a file block_activity_modules.php, the calendar_month folder contains a file block_calendar_month.php, the learning_resources folder contains a file block_learning_resources.php etc. Modules follow a similar pattern.
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.