#Laravel-Elixir-Wiredep
This is a simple wrapper around Laravel Elixir for Wiredep.
Install the module with npm:
laravel-elixir >v3.x
$ npm install --save-dev laravel-elixir-wiredeplaravel-elixir < v2.x
$ npm install --save-dev [email protected]And add it to your Elixir-enhanced Gulpfile, like so:
var elixir = require('laravel-elixir');
require('laravel-elixir-wiredep');
elixir(function(mix) {
mix.wiredep();
});Then you just have to edit your php file(s) and some extra markup, like this:
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<!-- bower:css -->
<!-- endbower -->
</head>
<body>
<!-- bower:js -->
<!-- endbower -->
</body>
</html>This will scan your Bower dependencies on bower.json and inject them all in your .php files inside resources/views/ directory. Instead, if you only want to inject dependencies on a single file, you may do:
mix.wiredep({src: 'master.blade.php'})If you run $ gulp watch this will also watch your bower.json for any changes and inject them automatically.
Whenever you install a new bower package with the -S flag your php files will be updated.
Since Wiredep serves bower components, these must inside the public folder.
Just create a .bowerrc file in the root of your project folder and specify the destination folder inside the public folder, like so:
{
"directory" : "public/bower_components"
}This wrapper accepts three optional parameters with configurations:
mix.wiredep(type, config, opts);- type - a string with the type of file
'php','sass','scss','less' - config - an object with the configs for the laravel-elixir-wiredep package
- opts - an object with the configs for the wiredep package, you can get more info about it here
These are the default wrapper options and the default wiredep options for each type of file:
sass: {
config: {
baseDir: 'resources/assets/sass',
src: false,
searchLevel: '**/*.sass'
},
opts: {
ignorePath: ''
}
},
scss: {
config: {
baseDir: 'resources/assets/sass',
src: false,
searchLevel: '**/*.scss'
},
opts: {
ignorePath: ''
}
},
less: {
config: {
baseDir: 'resources/assets/less',
src: false,
searchLevel: '**/*.less'
},
opts: {
ignorePath: ''
}
},
php: {
config: {
baseDir: 'resources/views/',
src: false,
searchLevel: '**/*.php'
},
opts: {
ignorePath: /(\..\/)*(public)?/,
fileTypes: {
php: {
block: /(([ \t]*)<!--\s*bower:*(\S*)\s*-->)(\n|\r|.)*?(<!--\s*endbower\s*-->)/gi,
detect: {
js: /<script.*src=['"]([^'"]+)/gi,
css: /<link.*href=['"]([^'"]+)/gi
},
replace: {
js: '<script src="{{filePath}}"></script>',
css: '<link rel="stylesheet" href="{{filePath}}" />'
}
}
}
}
}You can override the default options, by just passing them as second and third options or in case of PHP files you can omit the first parameter type and just pass the options.
var elixir = require('laravel-elixir');
require('laravel-elixir-wiredep');
elixir(function(mix) {
mix.wiredep('php',{ src: 'master.blade.php' }, { ignorePath: null } );
//if your first parameter is php you can omit it and achieve the same result
mix.wiredep({ src: 'master.blade.php' }, { ignorePath: null } );
});This is an example of a Gulp file that Wiredeps only your javascript and CSS dependencies into the resources/views/master.blade.php:
var elixir = require('laravel-elixir');
require('laravel-elixir-wiredep');
elixir(function(mix) {
mix.wiredep({src: 'master.blade.php'});
});This is an example of a Gulp file that Wiredeps only your javascript and CSS dependencies into all the PHP files, inside the resources/views/ folder, that have the bower tags:
var elixir = require('laravel-elixir');
require('laravel-elixir-wiredep');
elixir(function(mix) {
mix.wiredep();
});This one is an example of a Gulp file that Wiredeps only your scss dependencies into your Scss file and compiles it into the public/css/app.css:
var elixir = require('laravel-elixir');
require('laravel-elixir-wiredep');
elixir(function(mix) {
mix.wiredep('scss')
.sass('app.scss');
});On your app.scss just add the bower comments.
// bower:scss
// endbower
@import "someLocalScssFile";
$white: #ffffff;
$black: #000000;This one is an example of a Gulp file that Wiredeps only your sass dependencies and compiles your Sass file into the public/css/app.css:
var elixir = require('laravel-elixir');
require('laravel-elixir-wiredep');
elixir(function(mix) {
mix.wiredep('sass')
.sass('app.sass');
});On your app.sass just add the bower comments.
// bower:sass
// endbower
@import "someLocalSassFile";
$white: #ffffff;
$black: #000000;This one is an example of a Gulp file that Wiredeps only your less dependencies and compiles your Less file into the public/css/app.css:
var elixir = require('laravel-elixir');
require('laravel-elixir-wiredep');
elixir(function(mix) {
mix.wiredep('less')
.less('app.less');
});On your app.less just add the bower comments.
// bower:less
// endbower
@import "someLocalSassFile";
$white: #ffffff;
$black: #000000;If you want to Wiredep your sass/scss/less styles and also Wiredep Javascript and/or css into your PHP files, you just have to Wiredep twice.
var elixir = require('laravel-elixir');
require('laravel-elixir-wiredep');
elixir(function(mix) {
mix.wiredep('scss')
.sass('app.scss')
.wiredep();
});