Permalink
Browse files

Update README.md

  • Loading branch information...
1 parent 1211d4c commit 71e047dc09da19dc55dd6191de80671d8adc44c8 @juanpescador committed Dec 28, 2012
Showing with 30 additions and 13 deletions.
  1. +30 −13 README.md
View
@@ -1,19 +1,36 @@
-Slideshow module
+# Slideshow module #
-This is the Moodle 2 version of the slideshow module for images.
+This fork implements comments, reading position saving and video-adding. Developed as part of coursework for an
+Open-Source Software course.
-james@velomatic.com
-updated 30/11/2010 for Moodle 2.0 (Release version) by alan.whittamore@castlecollege.ac.uk
+## Authors ##
+ * james@velomatic.com (https://github.com/noparadise)
+ * alan.whittamore@castlecollege.ac.uk
+ * Paul Vaughan (https://github.com/vaughany)
+ * Los tres mosqueteros for an Open-Source Software class
-Point it to a 'Main Files' directory and it displays all the images therein as thumbnails and
-one resized image.
+## Installation ##
+Clone the repository, rename the folder from `moodle-mod_slideshow` to `slideshow`. Place it in `moodle/mod/`
+and navigate to your moodle site. It should prompt you to install the plugin.
-Click on a thumbnail to navigate, click on the image to progress.
+## Usage ##
+### Slideshow creation ###
+On your computer:
+ * Export a presentation to images (for example OpenOffice's export to HTML).
+ * Create a zip file of the folder with images.
-New updated version allows users (>= teacher) to choose
- whether to display captions, titles and edit them
- position of thumbnails and captions relative to main image
- options for auto-progress of slides in new window
+In Moodle:
+ * Add a "slideshow" activity.
+ * Upload the zip file and unzip it.
-config edits - resize maximum dimensions (x and y pixels)
- whether to include some javascript to disable right-clicking and remove the "image in new window" link
+### Slideshow usage ###
+Click on a thumbnail to navigate, click on the image to progress. The reading position is kept for each slideshow.
+One YouTube or Vimeo video can be added to each slide and positioned by dragging and dropping. Comments can be added
+to each slideshow.
+
+Users with teacher role and upwards can choose
+ * Whether to display captions, titles and edit them
+ * Position of thumbnails and captions relative to main image
+ * Options for auto-progress of slides in new window
+ * Slide maximum dimensions (x and y pixels)
+ * Whether to include some javascript to disable right-clicking and remove the "image in new window" link

0 comments on commit 71e047d

Please sign in to comment.