taylornetwork/toastr

A laravel class that will generate Toastr messages using toastr.js

Toastr for Laravel

A simple facade for Laravel 5 to generate toastr message using toastr.js., _(*1)

Install

Via Composer, _(*2)

``` bash $ composer require taylornetwork/toastr, <sub>(*3)</sub>

## Dependencies

You will need to include `toastr.js` on your pages.

You can install using bower

``` bash
$ bower install toastr

or include from CDNjs., <sub>(*4)</sub>

``` html , <sub>(*5)</sub>

*This may not be the most up to date information, see [CodeSeven/toastr][link-toastr]*

## Setup

### Provider Setup

Add the service provider to the providers array in your `config/app.php`

``` php
'providers' => [

    TaylorNetwork\Toastr\ToastrServiceProvider::class,

],

Facade Setup

Add the Toastr facade to your aliases array in config/app.php, <sub>(*6)</sub>

While this is optional, it is greatly recommended because Toastr::render() will be used in your base view and is easier than having to include the Toastr class., <sub>(*7)</sub>

``` php 'aliases' => [, <sub>(*8)</sub>

'Toastr' => TaylorNetwork\Toastr\Facades\Toastr::class,

],, <sub>(*9)</sub>

### Publishing Config

``` bash
$ php artisan vendor:publish

Will add config/toastr.php to your project., <sub>(*10)</sub>

View Setup

You will need to include the toastr.js and toastr.css files from bower or CDNjs (see Dependencies section above) in your base views., <sub>(*11)</sub>

You will also need to add the following line after both files are included in order to render Toastr messages., <sub>(*12)</sub>

``` php // app.blade.php, <sub>(*13)</sub>

, <sub>(*14)</sub>

{!! Toastr::render() !!}, <sub>(*15)</sub>

## Usage

Include `TaylorNetwork\Toastr\Facades\Toastr` in what ever class you plan on generating a Toastr message.

By default the styles available are `success`, `error`, `info`, `warning`. But you can remove any in `config/toastr.php`

`TaylorNetwork\Toastr\Toastr` uses a magic method to generate toastr messages.

To generate a success message

``` php
Toastr::success('Congratulations!');

Will push a success message to the session and will appear on the next request., <sub>(*16)</sub>

The magic method accepts a minimum of one parameter, the text you want to be displayed. The optional second parameter is the title of the message., <sub>(*17)</sub>

To add a custom title to the toastr message, <sub>(*18)</sub>

php Toastr::info('This is information!', 'New Info!!!');, <sub>(*19)</sub>

Credits

• Main Author: Sam Taylor

License

The MIT License (MIT). Please see License File for more information., <sub>(*20)</sub>