Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: Installing contributed modules or plugins.

Installing contributed modules or plugins: Difference between revisions

From MoodleDocs
 
(11 intermediate revisions by 8 users not shown)
Line 4: Line 4:
==Downloads==
==Downloads==


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


* [http://moodle.org/mod/data/view.php?id=6009 the Modules and plugins database] or
* [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>
* [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==
==Module 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.  
To install a contributed module:
# 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.
# 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 [http://filezilla-project.org/] 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.)
# Visit your admin page <nowiki>http://your_moodle_address/admin/index.php</nowiki> to complete the installation.
# Download the zip file and unzip it to your ''moodle/mod'' directory.  
# In your browser, go to your Moodle site:
Site Administration
  Notifications
    Continue
 
Note: The module may contain language files.  If so then just leave them in the folder and they'll be found automatically. These language strings can be customized using the standard ''Site Administration > Language'' editing interface.


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


Download the zip file and unzip it to:
Download the zip file and unzip it to:
Line 28: Line 34:
     Activities
     Activities
       Manage activities
       Manage activities
==Block installation==
To install a contributed block:
# Download the zip file and unzip it to your ''moodle/blocks'' directory.
# Visit your admin page <nowiki>http://your_moodle_address/admin/index.php</nowiki> to complete the installation.
==Other types of plugin==
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.
You can work out the correct place from the download link. If the download link is http://download.moodle.org/download.php/plugins19/mod/quiz/report/responses.zip, then after unzipping, the responses folder needs to be copied into the mod/quiz/report folder of your Moodle install.
After installing any plugin, you should visit the admin notifications page of your web site (URL .../admin/index.php) to allow the plugin to install itself if necessary. (It is not always necessary, but you should always check.)
==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 42: Line 71:
==See also==
==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]
*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]
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=58212 Please help - Cannot get additional blocks to install] forum discussion
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=131413 Moodle not installing a new Activity Module] forum discussion


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

Latest revision as of 22:18, 28 November 2010

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

Module installation

To install a contributed module:

  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. Download the zip file and unzip it to your moodle/mod directory.
  3. In your browser, go to your Moodle site:
Site Administration
  Notifications
    Continue

Note: The module may contain language files. If so then just leave them in the folder and they'll be found automatically. These language strings can be customized using the standard 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:

  1. Download the zip file and unzip it to your moodle/blocks directory.
  2. Visit your admin page http://your_moodle_address/admin/index.php to complete the installation.

Other types of plugin

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.

You can work out the correct place from the download link. If the download link is http://download.moodle.org/download.php/plugins19/mod/quiz/report/responses.zip, then after unzipping, the responses folder needs to be copied into the mod/quiz/report folder of your Moodle install.

After installing any plugin, you should visit the admin notifications page of your web site (URL .../admin/index.php) to allow the plugin to install itself if necessary. (It is not always necessary, but you should always check.)

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:

  1. The new block folder is named correctly. For example, the Learning Resources block folder should be named "learning_resources" (not "learning_resources_block").
  2. 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:

  1. Access Administration > Modules > Activities > Manage activities (or Administration > Modules > Activities in versions of Moodle prior to 1.9).
  2. Click on delete next to the module you wish to remove.
  3. 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:

  1. Access Administration > Modules > Blocks > Manage blocks (or Administration > Modules > Blocks in versions of Moodle prior to 1.9).
  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 moodle/blocks, otherwise Moodle will reinstall it next time you access the site administration.

See also