kotfire / system-alerts
Easy and simple system alerts for Laravel 4
Requires
- php: >=5.4.0
- illuminate/support: 4.2.*
This package is not auto-updated.
Last update: 2024-11-09 18:07:27 UTC
README
This is a Laravel 4 package to add an Alert system to a web application. It is designed to easily display one or more messages in a section of the web page. These messages are managed with artisan commands.
It includes a ServiceProvider and some commands to manage the alerts and automatically attach them to the output.
Installation
This package is available on packagist, just add it to your composer.json
"kotfire/system-alerts": "0.4.*"
After updating composer, add the ServiceProvider to the providers array in app/config/app.php
'Kotfire\SystemAlerts\SystemAlertsServiceProvider',
The alerts will be automatically injected to the output, but if you want to load them manually or do some extra actions you can add the facade to your facades in app/config/app.php
'SystemAlert' => 'Kotfire\SystemAlerts\Facades\SystemAlert',
Configuration
You can publish assets and configure it through Laravel.
To publish config file use
$ php artisan config:publish kotfire/system-alerts
In the config file you may modify the default values used in the package
To publish views use
$ php artisan view:publish kotfire/system-alerts
By publishing the views you may edit the template used to display the alert messages and make them your own style
Usage
Commands
The package was designed to display a Maintenance alert message before performing artisan down, but these are not the only type of alerts that can be added.
Maintenance alerts
Add new maintenance alert
$ php artisan alert:maintenance [-m "Custom message"] [-t "Next Maintenance (in minutes)"]
Note: Parameters are optional, default values will be used if not present
Example:
$ php artisan alert:maintenance
or
$ php artisan alert:maintenance -m "Maintenance in {time}" -t 15
This add new maintenance alert:
- Message: "Maintenance in {time}"
- Datetime: NOW + 15min
Example:
"Maintenance in {time}" will be "Maintenance in 14 minutes"
After putting app in maintenance mode using php artisan down the maintenance alert message will be deleted
Note: This will not occur if you use Artisan::call('down').
Important: You only can add one maintenance alert at time, if you try to add another you will get
Maintenance alert already exists: "Message"
Delete maintenance alert
$ php artisan alert:maintenance -d
Information alerts
Information alerts are a simple way to show some information to the web app users. This kind of alerts are not deleted automatically.
Add new alert
$ php artisan alert "Message" [-d "datetime"]
Example:
$ php artisan alert "This is an alert"
or
$ php artisan alert "This message will self-destruct in {time}" -d "12:50"
Common
Delete alert by ID
$ php artisan alert:delete ID
View all alerts
$ php artisan alert:list
Delete all alerts
$ php artisan alert:clear
Modifiers
There are some modifiers you can use and will be replaced when the message is displayed:
Sorting
Important: This feature was introduced in version 0.3, if you were using the package before this version re-publish the config file (Configuration)
Alerts can be sorted using one or more attributes.
By default the alerts will be sorted by type, then by the specified datetime and finally by the datetime they were created(all of them in ascending order).
The attribute 'type' is a bit special and needs more configurations, if you are using type sorting, you must set the priority. This is an array where the first element is the most priority and the last the less.
'type_priority' => ['maintenance', 'info'],
Configure
To configure the alerts sorting go to the config file.
Sorting can be a String(sort by ONE attribute) or an Array of strings(sort by more than one attributes).
Single attribute sorting:
'sort_by' => 'created_at',
Multiple attribute sorting:
'sort_by' => ['type', 'datetime', 'created_at'],
To define the order used in the attributes modify order
Order can be a String(same order for all attributes) or an Array of strings(different order for each attribute).
Same order:
'order' => 'asc',
Different order:
'order' => ['asc', 'desc', 'asc'],
Events
There are some events that will be fired:
Display
There are two ways to display the alerts: auto and manual
Auto
In this way alerts will be injected in all the responses containing a html element with the ID speficied in the config file (by default: 'alerts-container') using the template view to render them.
You just need to add a html container with the ID to all the views where you want to show the alerts.
Example:
<div id="alerts-container"></div>
Manual
If you want to inject the alerts yourself, this is perfect for you.
Ensure you have been added the facade (Installation) and set the config option 'inject' to false.
Now you may load the alerts using
$alerts = SystemAlert::loadAlerts();
and attach them to a View or do some logic with them.
License
System Alerts is open-sourced software licensed under the MIT license