hieu-le / laravel-alert
Laravel global site message system
Installs: 5 614
Dependents: 1
Suggesters: 0
Security: 0
Stars: 6
Watchers: 1
Forks: 4
Open Issues: 2
Requires
- php: >=5.6.0
- illuminate/config: ^5.0
- illuminate/session: ^5.0
- illuminate/support: ^5.0
- illuminate/view: ^5.0
Requires (Dev)
- orchestra/testbench: ^3.0
- phpunit/phpunit: ~4.0
README
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 valueicon
: 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());