Skip to content

intothesource/laravel-notification

Folders and files

NameName
Last commit message
Last commit date

Latest commit

d02582f · Feb 13, 2017

History

25 Commits
Feb 13, 2017
Feb 13, 2017
Oct 19, 2015
Oct 19, 2015
Feb 13, 2017
Nov 11, 2015

Repository files navigation

Notification

Flash notification that accepts a array and string. You can use it from your controller and also in the views.

Install

composer require intothesource/notification

After install

ServiceProvider

Add the following line to config/app.php.

at providers:

IntoTheSource\Notification\NotificationServiceProvider::class,

And at aliases:

'NotifyMessage' => IntoTheSource\Notification\Facade\NotifyMessage::class,

Publish files

Run the following command:

php artisan vendor:publish

Usage

Including the flash message in your view

To see the flash notification(s), you need to add the following @include().

@include('notification::message')

And if you want the basic styling that comes with the package, also inlcude the following lines:

<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css">
<link rel="stylesheet" href="{{ asset('assets/css/notification-style.css') }}">

And the javascript:

<script src="{{ asset('assets/js/notification.js') }}"></script>
NOTE: You also need the jQuery library.

Usage from the Controller

available functions

Creating a notification can be done with the next commands:

Notification::
    - success()
    - error()
    - warning()
    - info()
    - overlay() // Bootstrap modal

You can also add the class "Important" to the alert message, with the following command:

Notification::error('message', 'title')->important();

Message variables

You can send a message as a string or as a array.

Syntax:

Notification::success([
                    'First success',
                    'Second success title' => [
                        'First success',
                        'Second success'
                    ],
                    'Third success'
                ]);

Notification::success('First success');

Title

The last string is the title. You have two options: give a string or leave it blank.

With title:

Notification::success('First success', 'Title success block');

Without title:

Notification::success('First success');

Overlay function

When you want to use a Modal from bootstrap you can do so with the following function and syntax:

Notification::overlay( 'Message', 'Title' );
NOTE: All the given variables need to be a string.

Usage from the view

You can also create a notification from the view file, this is usefull when your using a ajax form.

available functions

Creating a notification can be done with the next commands:

Notification.
    - success()
    - error()
    - warning()
    - info()
    - overlay() // Bootstrap modal

Messages, Title and Important

You can send a message as a string or as a array.

NOTE: The overlay function only accepts strings.

Messages

The following syntax is used at all functions but NOT FOR: .overlay():

Single message:

Notification.success( 'First message' );

Multiple single messages:

Notification.success( ['First message', 'Second message', 'Third message'] );

Grouping messages:

Notification.success( {'Third message with array': ['First message', 'Second message']} );

Grouping messages inside a Array of messages:

Notification.success( ['First message', 'Second message', {'Third message with array': ['First message', 'Second message']}] );

Title

Adding a title to a notification:

Notification.success( 'message', 'The Title goes after the message' );

Important

Adding the class important to your notification is easly done with adding a boolean as last variable:

Notification.success( 'message', 'Title', TRUE );

Overlay function

When you want to use a Modal from bootstrap you can do so with the following function and syntax:

Notification.overlay( 'Message', 'Title', 'Button text' );
NOTE: All the given variables need to be a string.