View source

{{SloodleLanguageMenu|article=Install Sloodle}}
Please [[Download Sloodle]] if you have not done so already.

= Backup Moodle=
You are always recommended to make a backup of your Moodle data before installing new modules or applying updates. Do so now. 
See the Moodle [http://docs.moodle.org/en/Backup_FAQ Backup and Restore FAQ] for more information.

= Access your Moodle Installation =
* '''Use FTP''': Most likely you will need to use FTP software such as [http://filezilla-project.org FileZilla], Dreamweaver or Fugu
* '''Work locally''': If your Moodle is installed on your local PC, simply open up your file manager (e.g. "My Computer" on Windows)
* '''Use your Webhost's tools''': Sites like Dreamhost, Bluehost or Freehostia offer Web-based control panels to access files

= Sort the Unzipped Folders =

The Sloodle install comes in three separate folders. These are installed in different locations in the Moodle directory.

# '''sloodle''' is a Moodle "activity module" and is required
# '''sloodle_menu''' is a Moodle "block"
# '''sloodleobject''' is a Moodle "assignment plugin"

= Place the Sloodle Module = 

[[Image:MoodleFiles.jpg|thumb|Moodle file directory as seen in Dreamweaver]]
{{SloodleVersions|all}}
This is the primary part of Sloodle -- it is an activity module which you install into Moodle, and you can find it in the "sloodle" folder you downloaded earlier.

# Access your Moodle installation via FTP
# Open the "mod" folder and you will see folders such as ''assignment, chat, choice...''
# If there is already a folder called "sloodle", then '''delete''' it
# Copy in the "sloodle" folder that came in the archive you downloaded here
# Visit your Moodle admin page in your web-browser (add "admin" to your site's URL to access this)
# You will see an automated series of installation actions ending in "sloodle tables have been set up correctly"

= Place the Optional menu and assignment tools =

== Sloodle Menu Block (Optional) ==
{{SloodleVersions|0.2, 0.21, 0.3}}
This is an optional component which you can use to place a 'block' on your Moodle pages. When visible, the block will show the current user's avatar details (if known), along with useful links to important parts of Sloodle. It is recommended that you install for ease of navigation, but it is not essential. You can find the files in the "sloodle_menu" folder you downloaded earlier.

# Access your Moodle installation
# Open the "blocks" folder
# If there is already a folder called "sloodle_menu", then '''delete''' it
# Copy in your new "sloodle_menu" folder
# Visit your Moodle admin page in your web-browser

== Sloodle Object Assignment Plug-in (Optional) ==
{{SloodleVersions|0.3}}
This plugin is only available from Sloodle 0.3 onwards, and works like any other Moodle assignment type, and is required if you want to use the [[Sloodle PrimDrop]] tool. Unfortunately, it is also more complicated to install. You need to find the folder called "sloodleobject". It may be in the original folder which you downloaded, or alternatively, you may need to find it in your "sloodle" folder (see the Sloodle Module section above), by looking in "sloodle/mod/primdrop-1.0".

# Access your Moodle installation
# Open the "mod/assignment/type" folder
# If there is already a folder called "sloodleobject", then '''delete''' it
# Copy in your new "sloodleobject" folder

=== Assignment Plug-in Localization (Optional) ===
That is the basic plugin installed and ready, but you may also need to add a line to the language files. You will probably need to do this once for each language which your site uses:

# Access your Moodle installation
# Open the "lang/en_utf8" folder
# Download the "assignment.php" file (only necessary if you are connected remotely)
# Open the "assignment.php" file
# Scroll to the bottom of the file
# Immediately after the last "$string..." line, add a newline: $string['typesloodleobject'] = 'Sloodle Object';
# Save the file
# Upload your file back to your Moodle installation, overwriting the original (only necessarily if you are connected remotely)

You can perform the above steps for any other language. For example, if your site uses French, then open the "lang/fr_utf8" folder in step 2 instead.

= Activate the Tools =
Visit the Moodle administration page from your site's front page by clicking "Notifications" or "Admin..." on the administration menu. Try also adding "/admin" to your site's web address to access this feature. This will make sure Moodle finishes the installation, and makes any necessary database changes.

= Next Steps =
You are now ready to [[Configure Sloodle|configure Sloodle]] for your site, and then to [[Get the Sloodle Objects]].

{{SloodleDocs}}
[[Category:Sloodle]]
[[Category:SloodleAdminDocs]]