50

GitHub - mckenziearts/laravel-notify: Flexible Flash notifications for Laravel

 4 years ago
source link: https://github.com/mckenziearts/laravel-notify
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

readme.md

68747470733a2f2f6172746875726d6f6e6e65792e636f6d2f696d616765732f6c61726176656c2d6e6f746966792e737667

Build Status Total Downloads Latest Stable Version License

Introduction

Laravel Notify is a package that lets you add custom notifications to your project. A diverse range of notification design is available and many are coming soon.

68747470733a2f2f7069782e77617463682f35497943366a2f4253727a4e562e706e67

Work In Progress

This package is still under active development. If you need Android version please try this package Aesthetic Dialogs. Happy Coding 👨🏾‍💻

Installation

You can install the package using composer

$ composer require mckenziearts/laravel-notify

Then add the service provider to config/app.php. In Laravel versions 5.5 and beyond, this step can be skipped if package auto-discovery is enabled.

'providers' => [
    ...
    Mckenziearts\Notify\LaravelNotifyServiceProvider::class
    ...
];

You can publish the configuration file and assets by running:

$ php artisan vendor:publish --provider='Mckenziearts\Notify\LaravelNotifyServiceProvider'

Now that we have published a few new files to our application we need to reload them with the following command:

$ composer dump-autoload

Usage

  1. Add styles links with @notifyCss
  2. Add scripts links with @notifyJs
  3. use notify() helper function inside your controller to set a toast notification for info, success, warning or error
  4. Include notify partial to your master layout @include('notify::messages')

Basic

Within your controllers, before you perform a redirect call the notify method with a message.

public function store()
{
    notify()->success('Laravel Notify is awesome!');

    return Redirect::home();
}

An complete example:

<!doctype html>
<html>
    <head>
        <title>Laravel Notify</title>
        @notifyCss
    </head>
    <body>
        
        
        @include('notify::messages')
        @notifyJs
    </body>
</html>

Type of notifications

Laravel Notify actually display 4 types of notifications

  1. toast notification, who is default notification for Laravel Notify
notify()->success('Welcome to Laravel Notify ⚡️')
  1. connectify notification, example of basic usage
connectify('success', 'Connection Found', 'Success Message Here')
  1. drakify (😎) notification, only to display an alert
drakify('success') // for success alert 
or
drakify('error') // for error alert
  1. smilify notification, a simple custom toast notification using smiley 😊
smilify('success', 'You are successfully reconnected')

Config

Config file are located at config/notify.php after publishing provider element.

Some awesome stuff. To active dark mode update the theme config, or add global variable NOTIFY_THEME on your .env file

'theme' => env('NOTIFY_THEME', 'dark'),

Got result like that

68747470733a2f2f7069782e77617463682f64355470466c2f5a37657274392e706e67

Laravel Notify use animate.css to set smooth animation to display and hide notify element.

/*
|--------------------------------------------------------------------------
| Animate Module (use animate.css)
|--------------------------------------------------------------------------
|
| Use animate.css to animate the notice.
|
*/

'animate' => [
    'in_class' => 'bounceInRight', // The class to use to animate the notice in.
    'out_class' => 'bounceOutRight', // The class to use to animate the notice out.
    'timeout'   => 5000 // Number of seconds before the notice disappears
],

Change log

Please see the changelog for more information on what has changed recently.

Contributing

Please see contributing.md for details and a todolist.

Security

If you discover any security related issues, please email author email instead of using the issue tracker.

Credits

License

license. Please see the license file for more information.


report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK