administrcms / asset-manager
Installs: 1 046
Dependents: 2
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 1
Open Issues: 0
Requires
- php: >=5.5.9
- laravel/framework: >=5.2
Requires (Dev)
- codeclimate/php-test-reporter: dev-master
- phpunit/phpunit: 4.8.*
README
Installation
Using Composer:
composer require administrcms/asset-manager
Add the service provider:
\Administr\Assets\AssetsServiceProvider::class,
The Facade:
'Asset' => \Administr\Assets\AssetsFacade::class,
Usage
Base usage
The asset manager works with the Laravel framework. It provides a Facade for easier usage.
You can specify your asset groups by either the add
method or using the magical method.
Asset::add('test.css', 'css'); // is the same as Asset::addCss('test.css');
You can retrieve a group either by the get
method or the magical equivelent.
Asset::get('css'); // is the same as Asset::getCss();
You can also specify a priority for your asset. For example when using the jQuery library, you need to include it before any other library that depends on it.
// The sort is from highest to lowest priority. The default priority is 0. Asset::addJs('jquery.js', 100); Asset::add('jquery.js', 'js', 100);
Shortcuts
You can define a shortcut, which is a class that defines multiple assets at once. If you are using a js library that needs to include js and css code, you can make it easier.
// Create a class that implements the Shortcut contract class WysiwygShortcut implements Administr\Assets\Contracts\Shortcut { public function execute() { Asset::addJs('tinymce.js'); Asset::addCss('tinymce.css'); Asset::addCss('tinymce.theme.css'); } } // Register it with the Asset Manager Asset::shortcut('wysiwyg', WysiwygShortcut::class); // And then call it like a method of the Manager Asset::wysiwyg();
It is up to you to decide where to register the shortcuts. A good place would be in a ServiceProvider in you Laravel app.