jrohde/smarty-ass

Bundle and minify JS and/or CSS files on the fly.

Smarty 3+ plugin to bundle and minify js and/or css files.

This Smarty plugin uses Matthias Mullie's Minify library to do it's minifications and bundling., _(*1)

It automatically checks for (JS/CSS) file/code changes and then rebuild's the minified/bundled output file., _(*2)

Table of Contents, _(*3)

1. Installation
2. Parameters
3. Usage/Examples

, _(*4)

Installation

Use Composer to include the library into your project:, _(*5)

$ composer.phar require jrohde/smarty-ass

Now add the plugin dir to your Smarty instance:, _(*6)

$smarty = new \Smarty();
$smarty->addPluginsDir('./path/to/vendor/rohdej/smarty-ass/');

You can check if the correct path was added by using:, _(*7)

var_dump($smarty->getPluginsDir());

, _(*8)

Parameters

• in (array) - absolute path('s) to local JS or CCS files, inline or style/ tags and/or external JS or css files.
• out (string) - absolute path to the minified and bundled file output (must be writable by the webserver/php user!). This parameter is optional and defaults to '/assets/(js/css)/${smarty_template_name}_combined.(css/js)'.
• ttl (integer) - time to live in of cached files in seconds. This is the maximum time a minified/combined file may exist before a complete rebuild. Note that when source files are modified the output file is regenerated, regardless of this value. This parameter is optional and defaults to '31536000' (a.k.a: 1 year).
• gzip (boolean) - gzip's the output file. Make sure your PHP/Webserver supports this! This parameter is optional and defaults to 'false'
• debug (boolean) - disables compilation and just output all as normal if set to: 'true'. This parameter is optional and defaults to 'false'

, _(*9)

Usage (in Smarty 3+ templates)

{ass in=['file1.js','file2.js'] out='/assets/combined_and_minified.js' ttl='3600' gzip='false' debug=false}

You may also use external js/css/cdn's like:, _(*10)

{ass in=[
    'https://code.jquery.com/jquery-git.min.js',
    'https://code.jquery.com/ui/1.12.1/jquery-ui.min.js'
] out='/assets/combined_and_minified.js' ttl='3600' gzip='false' debug=false}

Use/add inline css or js (but make sure to escape single/double quotes!):, _(*11)

{ass in=["
    <script>
    var cool = 'awesome';
    </script>
"] out='/assets/combined_and_minified.js' ttl='3600' gzip='false' debug=false}

Or even mix it all together:, _(*12)

{ass in=[
    'https://code.jquery.com/jquery-git.min.js',
    'https://code.jquery.com/ui/1.12.1/jquery-ui.min.js',
    'file1.js',
    'file2.js',
    '<script>
        var cool = \'awesome\';
    </script>'
] out='/assets/combined_and_minified.js' gzip='true'}