prologuephp / alerts by tabacitu

Prologue Alerts is a package that handles global site messages.
3,746,587
345
10
Package Data
Maintainer Username: tabacitu
Maintainer Contact: dries.vints@gmail.com (Dries Vints)
Package Create Date: 2013-07-18
Package Last Update: 2024-04-15
Home Page:
Language: PHP
License: MIT
Last Refreshed: 2024-04-18 03:03:01
Package Statistics
Total Downloads: 3,746,587
Monthly Downloads: 78,335
Daily Downloads: 2,989
Total Stars: 345
Total Watchers: 10
Total Forks: 35
Total Open Issues: 1

Alerts for Laravel 5

Build Status Quality Score Software License Packagist Version Total Downloads

Alerts is a package that handles global site messages in Laravel 5.

I first got the idea for creating this package after a blog post I read by Todd Francis. This package uses much of the concepts of his blog post as well as the concept of alert levels which Illuminate's Log package uses.

Maintained by Cristian Tabacitu thanks to its use in Backpack for Laravel (the most popular admin panel for Laravel).

Table of Contents

Installation

You can install the package for your Laravel 5 project through Composer.

$ composer require prologue/alerts

For Laravel 5.4 and below, register the service provider in app/config/app.php.

'Prologue\Alerts\AlertsServiceProvider',

Add the alias to the list of aliases in app/config/app.php.

'Alert' => 'Prologue\Alerts\Facades\Alert',

Configuration

The packages provides you with some configuration options.

To create the configuration file run this command in your command line app:

$ php artisan vendor:publish --provider="Prologue\Alerts\AlertsServiceProvider"

The configuration file will be published here: config/prologue/alerts.php.

Usage

Adding Alerts

Since the main AlertsMessageBag class which powers the package is an extension of Illuminate's MessageBag class we can leverage its functionality to easily add messages.

Alert::add('error', 'Error message');

Adding Alerts Through Alert Levels

By default, the package has some alert levels defined in its configuration file. The default levels are success, error, warning and info. The AlertsMessageBag checks if you call one of these levels as a function and registers your alert which you provided with the correct key.

This makes adding alerts for certain alert types very easy:

Alert::info('This is an info message.');
Alert::error('Whoops, something has gone wrong.');

You can of course add your own alert levels by adding them to your own config file. See above on how to publish the config file.

Flashing Alerts To The Session

At some times you want to remember alerts when you're, for example, redirecting to another route. This can be done by calling the flash method. The AlertsMessageBag class will put the current set alerts into the current session which can then be used after the redirect.

// Add some alerts and flash them to the session.
Alert::success('You have successfully logged in')->flash();

// Redirect to the admin dashboard.
return Redirect::to('dashboard');

// Display the alerts in the admin dashboard view.
return View::make('dashboard')->with('alerts', Alert::all());

Displaying Alerts

Remember that the AlertsMessageBag class is just an extension of Illuminate's MessageBag class, which means we can use all of its functionality to display messages.

@foreach (Alert::all() as $alert)
    {{ $alert }}
@endforeach

Or if you'd like to display a single alert for a certain alert level.

@if (Alert::has('success'))
    {{ Alert::first('success') }}
@endif

Display all messages for each alert level:

@foreach (Alert::getMessages() as $type => $messages)
    @foreach ($messages as $message)
        <div class="alert alert-{{ $type }}">{{ $message }}</div>
    @endforeach
@endforeach

If you'd like to learn more ways on how you can display messages, please take a closer look to Illuminate's MessageBag class.

Changelog

You view the changelog for this package here.

License

Prologue Alerts is licensed under the MIT License.