Laravel 5 Macros

A useful set of HTML and Form macros with corresponding CSS and Javascript resources. Made for Bootstrap., _(*1)

Check out the 4.0 branch for Laravel 4 support., _(*2)

Getting started

Include the package in your application
Register the service provider
Publish and include the styles and scripts

View the examples., _(*3)

Include the package in your application

``` bash composer require lucasvdh/laravelmacros:5.*, _(*4)

Or add a requirement to your project's composer.json

``` javascript
    "require": {
        "lucasvdh/laravelmacros": "5.*"
    },

Register the service provider

Edit the config/app.php file. Append the following to the providers array:, _(*5)

``` php 'providers' => [ // ... Lucasvdh\LaravelMacros\MacroServiceProvider::class, // ... ],, _(*6)


If you didn't have the `laravelcollective/html` package yet, be sure to add that service provider too:

``` php
  'providers' => [
    // ...
    Collective\Html\HtmlServiceProvider::class,
    // ...
  ],

And register the aliases:, _(*7)

``` php 'aliases' => [ // ... 'Form' => Collective\Html\FormFacade::class, 'Html' => Collective\Html\HtmlFacade::class, // ... ],, _(*8)



## Publish and include the styles and scripts

``` bash
$ php artisan vendor:publish --provider="Lucasvdh\LaravelMacros\MacroServiceProvider"

Publishing a specific resource

``` bash $ php artisan vendor:publish --provider="Lucasvdh\LaravelMacros\MacroServiceProvider" --tag="scripts" $ php artisan vendor:publish --provider="Lucasvdh\LaravelMacros\MacroServiceProvider" --tag="styles" $ php artisan vendor:publish --provider="Lucasvdh\LaravelMacros\MacroServiceProvider" --tag="images", _(*9)


The CSS and Javascript files will be published to `public/css` and `public/js`. 

Make sure to include these in the view where you want to use the macros. You have two choices for including the styles and scripts.

### Include all

Either you include all the plugins as a minified file.

``` html
<html>
    <head>
        ...
        <link href="/css/laravel-macros.css" rel="stylesheet">
    </head>
    <body>
        ...
        <!-- Include Javascript at the end of body to improve page load speed -->
        <script src="/js/laravel-macros.js" type="text/javascript"></script>
    </body>
</html>

Include specific plugins

Or you include specific plugins., _(*10)

``` html , _(*11)

... ...

    <!-- IMPORTANT this file is required for the plugins to function -->
    <script src="/js/laravel-macros-app.js" type="text/javascript"></script>
</body>

, _(*12)


# That's it

You can now use the macros and all should work. Customization of the CSS and Javascript files should be straight forward.

Below, a few examples are given how to use these macros:

## Examples

Date picker

``` blade
{!! Form::datepicker('field_name', $default, ['class' => 'some-class']) !!}

datepicker , _(*13)

datepicker-extended , _(*14)

Chosen select, _(*15)

``` blade {!! Form::chosen('field_name', $default, $list, ['class' => 'some-class']) !!}, _(*16)


![chosen](http://download-manager.nl/lucasvdh/laravelmacros/chosen-select.png "Chosen select")

![chosen-extended](http://download-manager.nl/lucasvdh/laravelmacros/chosen-select-extended.png "Chosen select extended")

Material checkbox

``` blade
{!! Form::materialCheckbox('field_name', $checked, 'This is the checkbox text', 'value', ['class' => 'some-class']) !!}

material-checkbox , _(*17)