README

Author: Fabrizio Branca

Overview

This module adds the last-modified timestamp to your JS and CSS merged files to enabled browser-based caching and speed up your server.

Installation

Add following lines to your .htaccess file if storage is set to "database" and you are using apache as your web server.

Get merged js and css files from database using get.php if they do not exist in filesystem

RewriteCond %{REQUEST_URI} ^/media/css/.*\.css$ [OR]
RewriteCond %{REQUEST_URI} ^/media/js/.*\.js$

never rewrite for existing files

RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule .* ../get.php [L]

Add versions to files

If you enable one of the following in the configuration make sure to add this to your .htaccess file:

• Add version to assets (gif|png|jpg)
• Add version to assets (css) NOTE: only works with skin_css (not js_css)
• Add version to assets (js) NOTE: only works with skin_js (not js - coming from /js)

RewriteRule (.*)\.(\d{10})\.(gif|png|jpg)$ $1.$3 [L,NC]
RewriteRule (.*)\.(\d{10})\.(css)$ $1.$3 [L,NC]
RewriteRule (.*)\.(\d{10})\.(js)$ $1.$3 [L,NC]

If you use NGINX, add the following lines to your nginx config within the server block for your site if you use database as the file storage location:

location ^~ /media/js/ {
    try_files $uri $uri/ @handlerjs;
}

location ^~ /media/css/ {
    try_files $uri $uri/ @handlercss;
}

location @handlerjs {
    rewrite /media/js/ /get.php;
}

location @handlercss {
    rewrite /media/css/ /get.php;
}

If you enable the Add timestamps to asset files feature, also add these lines to your nginx config file

they should NOT be added to any particular location block.

rewrite "^/(.*)\.(\d{10})\.(gif|png|jpg)$" /$1.$3 last;

Release notes

v0.8.1

• Use adding sequence for sorting items without given prio

v0.8.0

• Added system configuration setting to take store id's into account when generating the filename hash
• Added configuration to sort assets by priorities:

<action method="addItem">
    <type>skin_js</type>
    <name>js/app.js</name>
    <params/>
    <if/>
    <cond/>
    <prio>100</prio>
</action>

v0.7.1

• added unit tests
• removed JSMin since it wasn't used
• getSkinUrl now also optionally adds the version key to image assets

v0.7.0

• Allowing to add timestamps to js and css files too now. Feature "inspired" by Tymek's commit.

v0.6.0

• CDN support is removed. Use https://github.com/AOEpeople/Aoe_MergedJsCssCdn if you need CDN support.