JS/CSS Chunker (Minifier)

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: https://github.com/hieblmedia/JsCssChunker).

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.

Protocol-Relative Url's

If enabled, all absolute urls like 'http(s)://path/file' will be replaced with '//path/file' to support SSL and Non-SSL.

Known issues:
IE7 and IE8 load @import files twice. Because @import disappears on merge, this problem can be neglected.

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 YUI-Compressor (recommended if Java is available), JSMin (recommended without Java), 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.

  • YUI-Compressor: Recommended if Java is available (see Java Path), Best compression.
  • Google Closure Compiler: Recommended if Java is not available (see Java Path), Best compression.
  • JSMin: Normal compression
  • JSMinPlus: Hight compression, but more error sensitive

Java Path (required for YUI-Compressor)

Path to Java. In most cases 'java' only works. Elsewhere a full path is required (e.g. Windows='C:\Program Files\Java\jre6\bin\java.exe', Unix='/usr/bin/java'). When nothing works, ask your hosting provider how and whether Java is available. Enable 'Debug' to find Errors."


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.

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.