Installing Speck

Install Files

  1. Download the latest version of Speck API and CMS files.
  2. Create a "webapps" directory somewhere outside the public web directories for your web server (e.g. c:\inetpub\webapps or /var/www/webapps). Note that the ColdFusion user should have write access to this directory.
  3. Unpack the downloaded zip archive into the webapps directory. After doing so, you should have a speck directory inside webapps (e.g. c:\inetpub\webapps\speck)

ColdFusion Administrator Settings

  1. Create a template mapping, "/speck" to point to the physical Speck tags directory (e.g. c:\inetpub\webapps\speck\tags). Note the lack of a trailing slash in both the mapping and physical path.
  2. Add the Speck api directory to the to the custom tags path (e.g. c:\inetpub\webapps\speck\tags\api). You will need to restart the ColdFusion service for this change to take effect.

Adding Java Classes and Libraries to the Class Path (optional)

The download includes some Java classes and libraries for obtaining image dimensions and for tidying HTML input before saving. To allow Speck to use these, you need to make sure they can be found in the CLASSPATH for Java Virtual Machine that is used by ColdFusion.

With ColdFusion MX, you can just copy the classes and libraries to the "classes" and "lib" sub-directories of theCFMX WEB-INF directory (e.g. c:\ColdfusionMX\wwwroot\WEB-INF).

If you are using CF5, you can add them to the Class Path in the Java settings section of the CF Administrator. For example:
c:\inetpub\webapps\speck\tags\classes;c:\inetpub\webapps\speck\tags\lib\Tidy.jar