⚝
One Hat Cyber Team
⚝
Your IP:
216.73.216.187
Server IP:
13.127.59.50
Server:
Linux ip-172-31-46-210 5.15.0-1033-aws #37~20.04.1-Ubuntu SMP Fri Mar 17 11:39:30 UTC 2023 x86_64
Server Software:
Apache/2.4.41 (Ubuntu)
PHP Version:
7.4.3-4ubuntu2.29
Buat File
|
Buat Folder
Eksekusi
Dir :
~
/
var
/
www
/
ecommerce_pg
/
vendor
/
prologue
/
alerts
/
View File Name :
readme.md
# Alerts for Laravel 5, 6, 7 and 8 [](https://travis-ci.org/prologuephp/alerts) [](https://scrutinizer-ci.com/g/prologuephp/alerts) [](license.md) [](https://packagist.org/packages/prologue/alerts) [](https://packagist.org/packages/prologue/alerts) Global site messages in Laravel 8, 7, 6 and 5. Helps trigger notification bubbles with a simple API, both in the current page, and in the next page (using flash data). Created by [Dries Vints](https://github.com/driesvints) - he first got the idea after [a blog post](http://toddish.co.uk/blog/global-site-messages-in-laravel-4/) by [Todd Francis](http://toddish.co.uk/). This package uses much of the concepts of his blog post as well as the concept of alert levels which [Illuminate's Log package](https://github.com/illuminate/log) uses. Maintained by [Cristian Tabacitu](https://github.com/tabacitu) thanks to its use in [Backpack for Laravel](http://backpackforlaravel.com/). ## Table of Contents - [Installation](#installation) - [Configuration](#configuration) - [Usage](#usage) - [Adding Alerts](#adding-alerts) - [Adding Alerts Through Alert Levels](#adding-alerts-through-alert-levels) - [Flashing Alerts To The Session](#flashing-alerts-to-the-session) - [Displaying Alerts](#displaying-alerts) - [Changelog](#changelog) - [License](#license) ## Installation You can install the package for your Laravel 6 project through Composer. ```bash $ composer require prologue/alerts ``` For Laravel 5.4 and below, register the service provider in `app/config/app.php`. ```php 'Prologue\Alerts\AlertsServiceProvider', ``` Add the alias to the list of aliases in `app/config/app.php`. ```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: ```bash $ 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. ```php 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: ```php 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](#configuration) on how to publish the config file. ### Flashing Alerts To The Session Sometimes 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. ```php // 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. ```php @foreach (Alert::all() as $alert) {{ $alert }} @endforeach ``` Or if you'd like to display a single alert for a certain alert level. ```php @if (Alert::has('success')) {{ Alert::first('success') }} @endif ``` Display all messages for each alert level: ```php @foreach (Alert::getMessages() as $type => $messages) @foreach ($messages as $message) <div class="alert alert-{{ $type }}">{{ $message }}</div> @endforeach @endforeach ``` ### Checking For Alerts Sometimes it can be important to see if alert's do exist, such as only load javascript/styles if they are there are some (helps for better performance). You can check if there are any errors. ```php Alert::has(); // Will check for any alerts Alert::has('error'); // Will check for any alerts listed as errors. ``` You can also get the current number of alerts. ```php Alert::count(); // Will give you a total count of all alerts based on all levels within your alerts config. Alert::count('error'); // Will tell you only the amount of errors and exclude any levels. ``` If you'd like to learn more ways on how you can display messages, please [take a closer look to Illuminate's `MessageBag` class](https://github.com/illuminate/support/blob/master/MessageBag.php). ## Changelog You view the changelog for this package [here](changelog.md). ## License Prologue Alerts is licensed under the [MIT License](license.md).