hieu-le/laravel-alert

Laravel global site message system

2.2.0 2017-08-24 08:32 UTC

This package is auto-updated.

Last update: 2024-10-05 20:33:27 UTC


README

Build Status Latest Stable Version Code Climate Test Coverage Total Downloads License

Global site message system for Laravel 4 (for Laravel 5, see laravel-5 branch)

The purpose of this package:

  • Generate alerts in many semantic meaning: success, info, warning, error
  • Flash collected messages to the next request
  • Display collected messages to customizabled view, default to Bootstrap 3 alert
  • Support icons for each type of message.

Installation

You will need Composer to use this package. There is a nice tutorial of using Composer for those who are not familiar with this awesome tool.

Add this to your composer.json file.

"hieu-le/laravel-alert": "~1.0"

Run composer update to update all dependencies. After that, register the service provider for Laravel by adding this line to the providers array in app/config/app.php

'HieuLe\Alert\AlertServiceProvider',

And add this alias to the aliases array in app/config/app.php

'Alert' => 'HieuLe\Alert\Facades\Alert',

Usage

To add new message, use one of these four method. The name of each method is the type of the message you want to add.

Alert::success($message);
# or
Alert::info($message);
# or
Alert::warning($message);
# or
Alert::error($message);

To make these message available in next request, you must call Alert::flash() at least one time.

Alert::flash()

In your view, use the method Alert::dump to display these messages. By default, each type of message is rendered with the format of Bootstrap 3 alert. You can change they appearance by reading the configuration section below.

Configuration

You can get more control over this package by modifying these configuations. First of all, publish the package config, so that you can edit the copied version:

php artisan config:publish hieu-le/laravel-alert

Open app/config/packages/hieu-le/laravel-alert/config file and change these settings:

  • session_key: the name of the session key that stored messages between requests. You normally do not want to edit its value
  • icon: the icon for each type of message when rendered in the default view. You can remove the value of one key to disable the icon for that type of message.
  • view: the name of the view being used to render each type of message. In the view, you can use 2 variables: $icon is the icon of this message type; $messages: an array of messages of the current message type.

Work with Laravel validation errors result

To display the validation error, simply add another parameter to the Alert::dump method. For example

// In each view, there is a special variable call $errors
// This is the validation errors that is set by calling "withError" method as
// guided at http://laravel.com/docs/4.2/validation#error-messages-and-views

echo Alert::dump($errors->all());