You are here: Documentation > JYAML for Joomla! 1.7+, 2.5 > Configuration > JS/CSS Chunker (Minifier)

JS/CSS Chunker (Minifier)

JS/CSS Chunker (Merge and Minify)

The JS/CSS Chunker does minify Stylesheet and Javascript files and merge these to only one file. The developed PHP-Class is also available as a standalone version (see: http://chunker.hieblmedia.net/).

When you merge the files there is the advantage that the browser needs to make only one query. This can speed up considerably the optical page-load. And as a nice side effect it also reduces the traffic.

Merge/Minify Stylesheets

When enabled all stylesheets recursively (with @import) merged and minified in a secure way. On the CSS code itself no modifications are made to ensure compatibility as high as possible.

Note: Inline style definitions are not considered because it may be can have dynamic CSS-Code.

Merge Javascript

When enabled all scripts will be merged.

Note: Inline script definitions are not considered because it may be can have dynamic Javascript-Code.

Javascript Compressor

To minimize Javscript special methods are required.

Here you can choose between JSMin (recommended), JSMinPlus and JavascriptPacker. Javascript files are often already minimized. The compressor also tries to identify the file is already compressed. The compression still can produce javascript errors. If you have problems, the compressor can also be disabled and the files are merged only.

Cache

If the cache is enabled, the minified/merged files are stored in the Joomla! /cache/ directory. The cache should be activated in any case, if your site goes online, because without the cache is likely to have significant performance declines because the files are always reloaded and optimized.

The cache basically can stay enabled all times.
Because JYAML automatically detects whether files in the /css/ or /script/ directory of the template has changes and updates the cache automatically.

Output result as declaration

This setting is intended only for highly visited websites where every little connection request is performance relevant and there is no additional proxy server for static content.

When enabled, the merged Javascript- and CSS-Code will be added directly as style declaration in the HTML-Head. This has the advantage that no connection request must be made ​​longer. The disadvantage is of course the HTML-Source is larger. The benefit outweighs however.

Include external files

If this option is enabled, files that are not within the Joomla! Installation are included, too.

Add File-time hash

If enabled, a File-time hash (timestamp) will be added on the cached URL (e.g.: xyz.css?1304915629.css). This is useful to let the your site visitors automatically update the browser cache if the file has changed.

Note: This can produce 404 errors when you use an CDN hostname (proxy server).

CDN Hostname

CDN (Content Delivery Network) means an target Domain for an Proxy-Server like Nginx. The CDN Hostname will be replaced with the current Joomla! Domain. Please only type something here, when you know what is meant and only the hostname (e.g. static.my-domain.tld). The URL-Scheme (http, https) will be set automatically for a valid request.