README

A laravel alerts utility that help you show Toasts directly in your blade template instead of Javascript files.

Installation

Follow below steps

Step :- 1

Run composer require faisalahsan/laraalerts in your terminal

Step :- 2

Add Service Provider Open config/app.php and add FaisalAhsan\LaraAlerts\LaraAlertServiceProvider::class to the end of providers array:
```
'providers' => array(
    ....
    FaisalAhsan\LaraAlerts\LaraAlertServiceProvider::class,
),
```

Register Facade

'aliases' => array(
    ....
    'Toast'    =>  FaisalAhsan\LaraAlerts\Facade\ToastFacade::class,
),

Run below command
```
  php artisan vendor:publish
```

Step :- 3

Include files in your layout

    <link rel="stylesheet" href="/css/toast.css">
    <script type="text/javascript" src="/js/toast.js"></script>

How to use

In you blade template

{{ Toast::info( 'Saved', 'Item saved')->run() }}

Toast Types

info('heading', 'message text')

First parameter shows title of the Toast
Second parameter shows message to be display
{{ Toast::info('Info', 'Info Toast')->run() }}

warning('heading', 'message text')

First parameter shows title of the Toast
Second parameter shows message to be display
{{ Toast::info('Warning', 'Warning Toast')->run() }}

error('heading', 'message text')

First parameter shows title of the Toast
Second parameter shows message to be display
{{ Toast::info('Error', 'Error Toast')->run() }}

success('heading', 'message text')

First parameter shows title of the Toast
Second parameter shows message to be display
{{ Toast::info('Success', 'Success Toast')->run() }}

Animation

fade() for fade transitions

  {{ Toast::info('Success', 'Success Toast')->fade()->run() }}

slide() for slide up and down transitions

  {{ Toast::info('Success', 'Success Toast')->slide()->run() }}

plain() simple show from and hide to corner transition

  {{ Toast::info('Success', 'Success Toast')->plain()->run() }}

Other Handy Functions

showCloseButton(true) Pass boolean (true or false) to show or hide cross button on toast, by default it is true

  {{ Toast::info('Success', 'Success Toast')->showCloseButton()->run() }}

hideAfter(3000) Specify the duration, for how long toast will be visile or pass false to make it sticky

**Hide after 3 seconds**
  {{ Toast::info('Duration', 'This toast will be disappear after 3 seconds')->hideAfter(3000)->run() }}

**Sticky**
  {{ Toast::info('Duration', 'This toast is a sticky toast.')->hideAfter(false)->run() }}

noOfToastToShow(1) how many toasts can be displayed in stack

  {{ Toast::info('Success', 'Success Toast')->noOfToastToShow(3)->run() }}

position() where toast will be displyed

  position can be one of these 
  ['bottom-left', 'bottom-right', 'top-right', 'top-left', 'bottom-center', 'top-center', 'mid-center']
  {{ Toast::info('Toast Position', 'Toast is displayed in the center position.')->position('top-center')->run() }}
  
  or simple object
  { top: - , bottom: -, left: -, right: - }
  {{ Toast::info('Toast Position', 'Toast is positioned using object.')->position("{ top: '12' , bottom: '12', left: '12', right: '12' }")->run() }}

textAlign() define text alignment e.g. left, right, center

  {{ Toast::info('Text Alignment', 'Text has left alignment.')->textAlign('left')->run() }}

loader('#9EC600' ) show loader with color value

  {{ Toast::info('Text Alignment', 'Text has left alignment.')->loader('#9EC600')->run() }}
color value can be Hexa value or Html color name

Thanks

Special thanks to Kamran Ahmed

How to Contribute

Feel free to add some new functionality, improve some existing functionality etc and open up a pull request explaining what you did.
Report any issues in the issues section
Also you can reach me directly at faisalahsan.se@gmail.com with any feedback

faisalahsan / laraalerts

Maintainers

Details