INSTALL.txt

This filter takes advantage of the excellent open-source Jmol/JSmol 3D chemical structure visualisation project 

http://jmol.sourceforge.net
 
The filter includes some some basic controls and help files.

This version defaults to the HTML5/JSmol JavaScript version of Jmol for maximum cross-platform functionality.
The user can also select HTML5/GLmol (WebGL) or signed Java Jmol Applet options.
Tested with Firefox 20, Chrome 26, Opera 12, Internet Explorer 10, 9 and 8 (IE 8 defaults to Java applet)

This filter deploys each JSmol instance within an iframe to minimise potential clashes with other Moodle JavaScript.

TO INSTALL:

1. Unpack this .zip or .tar.gz download.
2. Rename the /moodle-filter_jmol folder to /jmol.
Copy this /jmol folder (and all its contents) to inside the /filter folder of your Moodle 2.x installation
i.e. alongside the folders for other filters. Set the permissions of the /jmol folder to be those of the Web server.

Remember to activate the filter in Moodle's filter admin screen. 
Depending on settings, you may need to activate this filter in individual Moodle courses.

Jmol/JSmol is under active development. The latest JSmol version is available from:

http://chemapps.stolaf.edu/jmol/jsmol.zip

If required, this may be downloaded and and unpacked and the /jsmol folder (and its contents) 
used to replace the /filter/jmol/js/jsmol folder to update to the very latest version.