/depot-cbox-jsmin

Our own breed of JS and CSS minifier for ColdBox applications

Primary LanguageColdFusionApache License 2.0Apache-2.0

Author 	 :	Luis Majano
Description :

This is a plugin that interfaces with our own flavor of JSMin to minify
css and js files.  It can also compress several files of the same type
into a single include.

Configuration Settings:

jsmin_enable : boolean (defaults to true)  
	- flag to enable disable the packaging process
jsmin_cacheLocation : string (REQUIRED)
	- the relative file location where cached minified js/css files will be stored,
	  this location will be expanded. ex: includes/cache	
	  
Usage:

* minify(assets:string) : html script or link

The main method of operation is minify().  You pass to it a list of assets to compress,
but they have to be of the same type: js or css.  Do not alternate or weird results will
happen.  This method returns a script or link include that you would output on your layouts:

<head>
#getMyPlugin("JSMin").minify('includes/js/myscripts.js','includes/js/jquery.js')#
#getMyPlugin("JSMin").minify('includes/css/site.css','includes/css/boxes.css')#
</head>

As you can see from the example above, you can easily render the minified version of all
the assets.  This plugin will minify each asset and if more than 1 is declared, then it
will build a concatenated version of the js or css assets and cache them.

* minifyToHead(assets:string) : void

This method basically sends the html links and script tags to the head section using
cfhtmlhead.  You can use this method when calling JSMin via handlers or plugins or any other
location than layouts.

======================================================================
CHANGELOG
======================================================================
Vesion 1.7
# Addition of fixes to complex css patterns like input[type="button"] p, basically anything in closing brackets

Version 1.6
# Oops fixes

Version 1.5

# Added ability to store files without using a UUID so they can survive fwreinits and load balancing
  thanks to Scott ColdWell
# Updated to use StringBuilder instead of Buffer.
# Fixing of empty first line

Version 1.4

# Updates to core java processor to add more funky css definitions via commenting system in css and js.

Version 1.3

# Updates to core java processor to add more funky css definitions

Version 1.2

# Fixes to trimming incoming assets

Version 1.1

# Updates to core java processor to distinguish between css and js compression
# Fixed negative margin issues with css compression
# Fixed advanced spaced selectors with css compression

Version 1.0

# Initial Release