morningtrain/enqueuer

Laravel package to enqueue css and js files for load. It supports dependencies, caching and passing data to scripts from PHP.

enqueuer

, _(*1)

Laravel package to enqueue css and js files for load. It supports dependencies, to serve files in the correct order, caching, magic methods and passing along PHP variables., _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require morningtrain/enqueuer, <sub>(*4)</sub>

Add this service provider to your config/app.php file.

``` php
morningtrain\enqueuer\enqueuerServiceProvider::class,

Usage

In all of the below cases, "Admin" can be any word and is used to group styles and scripts. A common use case is to have different scripts in admin and frontend., <sub>(*5)</sub>

To enqueue a script or style

``` php, <sub>(*6)</sub>

Enqueuer::addAdminScript('jquery', [ 'location' => 'https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js' ]);, <sub>(*7)</sub>

Enqueuer::addAdminScript('sample', [ 'content' => "console.log('sample');", 'dependencies' => ['jquery'] ]);, <sub>(*8)</sub>

The syntax for adding styles and scripts are almost the same. The main difference is that you would call "addAdminStyle" in the above example instead.
In addition, note that it is not possible to use the data property with styles.

### Script dependencies

Some scripts and styles might be dependent on others. To solve this, one can add the dependencies property.
The value of this property is an array that contains the names of all the script/styles it is dependent on.
The scripts/styles will be sorted according to the dependencies.

``` php

Enqueuer::addAdminScript('sample', [
    'content' => "console.log('sample');",
    'dependencies' => ['jquery']
]);

Enqueuer::addAdminScript('jquery', [
    'location' => 'https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js'
]);

Pass PHP data to script

It is possible to pass on a data object to a script by including the data properties., <sub>(*9)</sub>

The value of data is an array containing the name of the object and the properties., <sub>(*10)</sub>

``` php Enqueuer::addProfileScript('config_test', [ 'content' => "console.log(config.baseUrl);", 'data' => [ 'object' => 'config', 'properties' => [ 'baseUrl' => url('') ] ] ]);, <sub>(*11)</sub>

### Including script and styles in views

To include scripts in view

``` php

{!! Enqueuer::getAdminScripts() !!}

To include styles in view, <sub>(*12)</sub>

``` php, <sub>(*13)</sub>

{!! Enqueuer::getAdminStyles() !!}, <sub>(*14)</sub>

### Cache control

#### Clear all caches

Clear everything
``` php

Enqueuer::clearAllCache();

To clear all caches for scripts ``` php, <sub>(*15)</sub>

Enqueuer::clearScriptsCache();, <sub>(*16)</sub>

To clear all caches for styles
``` php

Enqueuer::clearStylesCache();

To clear all caches for scripts in group (admin in this case) ``` php, <sub>(*17)</sub>

Enqueuer::clearAdminScriptsCache();, <sub>(*18)</sub>

To clear all caches for styles in group (admin in this case)
``` php

Enqueuer::clearAdminStylesCache();

Managing settings

Settings can be overwritten at any time using this snippet: ``` php, <sub>(*19)</sub>

Enqueuer::configure([ 'cacheScripts' => true, 'cacheStyles' => true, 'alwaysGenerateStylesCache' => false, 'alwaysGenerateScriptsCache' => false, 'storageDisk' => 'public' ]);, <sub>(*20)</sub>

```, <sub>(*21)</sub>

It allows for enabling / disabling cache for scripts and styles, as well as allowing the cache for being regenerated on every request. Note, that in order to use it without caching, all enqueued scripts have to be publicly available on the provided url., <sub>(*22)</sub>

Change log

Please see CHANGELOG for more information what has changed recently., <sub>(*23)</sub>

Security

If you discover any security related issues, please email mail@morningtrain.dk instead of using the issue tracker., <sub>(*24)</sub>

Credits

• Morning Train

License

GNU General Public License v3.0. Please see License File for more information., <sub>(*25)</sub>