mmanos/laravel-casset

An asset management package for Laravel 4.

Casset Package for Laravel 4

Casset is an asset manager for Laravel 4 applications. Some things it can do:, _(*1)

• Create one or more asset containers.
• Compile less files.
• Combine assets into one file.
• Minify output.
• Accept assets from Laravel package public directories. "vendor/package::/js/file.js"
• Define dependencies for an asset.
• Define global dependencies for all assets of the same file type.
• Define an optional CDN for asset URLs.
• Optionally defer processing/combining assets to a controller (useful when distributing page requests across multiple servers).

Installation via Composer

Add this to your composer.json file, in the require object:, _(*2)

"mmanos/laravel-casset": "dev-master"

After that, run composer install to install Casset., _(*3)

Add the service provider to app/config/app.php, within the providers array., _(*4)

'providers' => array(
    // ...
    'Mmanos\Casset\CassetServiceProvider',
)

Add a class alias to app/config/app.php, within the aliases array., _(*5)

'aliases' => array(
    // ...
    'Casset' => 'Mmanos\Casset\Facades\Casset',
)

Finally, ensure the cache directory defined in the config file is created and writable by the web server (defaults to public/assets/cache)., _(*6)

$ mkdir public/assets/cache
$ chmod -R 777 public/assets/cache
$ touch public/assets/cache/.gitignore

Edit public/assets/cache/.gitignore., _(*7)

*
!.gitignore

Upgrading to 1.3 from 1.2.x

Simply update the class alias in app/config/app.php to point to the new Facade:, _(*8)

'aliases' => array(
    // ...
    'Casset' => 'Mmanos\Casset\Facades\Casset',
)

Usage

Add assets to the "default" container:, _(*9)

Casset::add('js/jquery.js');
Casset::add('less/layout.less');

Add assets to a custom container:, _(*10)

Casset::container('layout')->add('js/jquery.js');
Casset::container('layout')->add('less/layout.less');

Add an asset with a dependency on another asset:, _(*11)

Casset::add('less/variables.less');
Casset::add('less/layout.less', array(), array('less/variables.less'));

Add a global dependency for all assets (of the same file type):, _(*12)

Casset::dependency('less/variables.less');
Casset::container('layout')->dependency('less/variables.less');

Add assets from a composer package (vendorName/packageName):, _(*13)

Casset::add('frameworks/jquery::/jquery.min.js');

Render HTML tags to load assets for a container:, _(*14)

{{ Casset::container('default')->styles() }}
{{ Casset::container('layout')->scripts() }}

Generate a URL to an asset on the CDN server:, _(*15)

<img src="{{ Casset::cdn('logo.png') }}" />