Merging/minifying CSS files

Check the /assets/nls directory of your locally installed demo, to see the result of the merging process!

General information

• The merging/minification is done by own algorithm, in the NLSCssMerge class. This class is independent from NLSClientScript and Yii, may be used separately, with other frameworks. Some time i may create a separate repo for it, but for now it's part of NLSClientScript.
• Merging is aware only js files registered via CClientScript::registerCssFile().
• NLSClientScript groups the registered css files by the "media" attribute of the link.
• The merged files are saved into the app's /assets/nls directory.
• The merged files are named by hashing the urls of the files merged in.
• NLSClientScript doesn't watch the changing of the files to be merged, it only checks the existance of the merged file - in order to update it, that need to be removed or need to set the $forceMergeCss member to true (only for debugging/development).

Configuration options (/protected/config/main.php)

//part of /protected/config/main.php:
'components'=>array(
...
    'clientScript' => array(
        ...
        //------ General NLSClientSript settings ------
        //see Merging JS page
 
        //------ CSS-merge specific settings ------
        //do merge!
        'mergeCss' => true,
        //EXPERIMENTAL - if true, all resources referred by url (webfonts, images etc) will be cloned locally 
        'downloadCssResources' => true,
        //if the below is true, the merged files will be re-composed on every request - ONLY for debugging/development
        'forceMergeCss' => false,
        //only merge if at least two files are linked
        'mergeAbove' => 1,
        //do minification on the result
        'compressMergedCss' => false,
        //Filtering for merge - null or php regex here
        'mergeCssIncludePattern' => '/only_merge_this_pattern/i',
        'mergeCssExcludePattern' => '/no_merge_this_pattern/i',
        ...
    ),
...
)