xuma/laravel-amaran

Laravel 5 Notification

AmaranJS Laravel 5 Package

, _(*1)

AmaranJS L5 package is a Laravel wrapper for my jquery plugin AmaranJS.You can create easy and stylish notifications with AmaranJS., _(*2)

Package Demo: http://ersu.me/laravel-amaranjs, _(*3)

Installation

Begin by installing the package through Composer. You can add your composer.json require section:, _(*4)

"xuma/laravel-amaran": "1.1.0"

Don't forget to update composer update., _(*5)

Once this operation is complete, simply add both the service provider and facade classes to your project's config/app.php file:, _(*6)

Service Provider

Xuma\Amaran\AmaranServiceProvider::class,

Facade

'Amaran' => Xuma\Amaran\Facades\Amaran::class,

Installing AmaranJS jQuery Plugin

You can choose to install AmaranJS manually or you can publish assets., _(*7)

If you choose install manually, extract your AmaranJS files to public/ directory. You can find installation documentation of AmaranJS here., _(*8)

You can publish assets with below command and assets will be placed in /css, /js folders., _(*9)

php artisan vendor:publish --provider="Xuma\Amaran\AmaranServiceProvider" --tag="assets"

Default configuration.

If you want to use same configuration by default you can use configuration file. You can publish configuration file with below command., _(*10)

php artisan vendor:publish --provider="Xuma\Amaran\AmaranServiceProvider" --tag="config"

Adding Output View

Add required view after your jQuery and AmaranJS links., _(*11)

@include('amaran::javascript')

Example:, _(*12)

<script src="//cdn.jsdelivr.net/jquery/2.1.3/jquery.js"></script>
<script src="js/jquery.amaran.js"></script>
@include('amaran::javascript')

Usage

Usage is very simple.If you want to use default theme;, _(*13)

Amaran::content(['message'=>'Hello World!'])->create();

Using AmaranJS Functions

You can use most AmaranJS functions as methods like :, _(*14)

Amaran::content([ 'message'=>'Hello World!'])
    ->position('top right')
    ->inEffect('slideRight')
    ->outEffect('slideBottom')
    ->sticky(true)
    ->create();

Binding Javascript Events to Element

You can define javascript events with bind() method, _(*15)

Amaran::content(['message'=>'Hello World!'])
    ->position('top right')
    ->bind('#start','click')
  - >create();

Using as Flash Message

Normally AmaranJS bind to current view but you can add ->flash() method for bind to redirected methods view., _(*16)

Amaran::content(['message'=>'Hello World'])->flash()->create();

Theme Usage

Theme usage is simple just set theme name and set content as theme template array., _(*17)

Amaran::theme('awesome ok')->content([
        'title'=>'My first funcy example!',
        'message'=>'1.4 GB',
        'info'=>'my_birthday.mp4',
        'icon'=>'fa fa-download'
    ])->create();

Little note if you want to use awesome theme you have to include [font awesome][2]., _(*18)