Skip to content

skrajewski/laravel-flash-notifications

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Laravel Flash Notifications

build version license downloads

Flash Notifications Helper for Laravel 5

Install

Install via composer

Add dependency to your composer.json file and run composer update.

require: {
    "szykra/laravel-flash-notifications": "~0.3"
}

Configure Laravel

Add ServiceProvider and Alias (Facade) to your config/app.php file:

'Szykra\Notifications\NotificationServiceProvider'
'Flash' => 'Szykra\Notifications\Flash'

Include default alert view to your layout

Package default provides bootstrap ready alert view. Just include notifications::flash file to your main layout in blade:

@include('notifications::flash')

You can create own container for flash notifications with own custom styles. See Custom alert view section.

Usage

You can push flash message ever you need by facade Flash. It provides 4 alert types:

  • success
  • error
  • warning
  • info
Flash::info('Your alert message here!');

Method push() exists because you can push more than one alert at the same time. See below.

Every alert method takes 1 or 2 arguments. If you give one parameter it will be message. If you provide two parameters, first will be title and second will be message.

Flash::success('User has been updated successfully.');
Flash::error('Oh snap!', 'Something went wrong. Please try again for a few seconds.');

Custom alert view

Package default provides bootstrap ready view for alerts. You can define own style for it. Just create new blade template file!

@if(Session::has('flash.alerts'))
    @foreach(Session::get('flash.alerts') as $alert)

        <div class='alert alert-{{ $alert['level'] }}'>
            <button class="close" type="button" data-dismiss="alert" aria-hidden="true">&times;</button>

            @if( ! empty($alert['title']))
                <div><strong>{{ $alert['title'] }}</strong></div>
            @endif

            {{ $alert['message'] }}
        </div>

    @endforeach
@endif

All alerts will be in flash.alerts session variable. Single alert looks like:

[
  'title' => 'Title',
  'message' => 'Example message',
  'level' => 'success'
]

Level for all alerts are following:

  • Flash::success has level success
  • Flash::error has level danger
  • Flash::warning has level warning
  • Flash::info has level info

License

The MIT License. Copyright (c) 2014 - 2015 Szymon Krajewski.