spajz/msg

Simple notification system for Laravel 4

Simple notification system for Laravel 4

• Extends Laravel MessageBag class.
• Custom template support (comes with Bootstrap3, Bootstrap2 and Foundation5 template).
• Blade string like template.
• Custom groups.
• Formats and sorting for groups and messages.
• Instant and flashable notifications...

Installation

Application specific modules in Laravel 4 can be enabled by adding the following to your "composer.json" file:, _(*1)

"spajz/msg": "dev-master"

Then composer update., _(*2)

Add a new provider to your providers list in "app/config/app.php":, _(*3)

'Spajz\Msg\MsgServiceProvider',

Also add a new alias to aliases list in "app/config/app.php":, _(*4)

'Msg' => 'Spajz\Msg\Facades\Msg',

Configuration

If you want to edit default config file, just publish it to your app folder., _(*5)

php artisan config:publish spajz/msg

Usage

Add default messages

// Default groups
Msg::success('Success message');
Msg::error('Error message');
Msg::danger('Danger message');
Msg::info('Info message');
Msg::warning('Warning message');

// Multiple messages
Msg::info(array('First message', 'Second'));

Custom groups

You can add custom groups to config, and then use them like default groups., _(*6)

// Custom groups
Msg::exit('Exit message');
Msg::break('Break message');

// Custom key
Msg::custom('bar', $message, 'Bar group message format :message');
Msg::custom('foo', array($foo, $bar, 'Some text'), 'Format :message');

Show messages

// Show all messages from the previous request
Msg::show();

// Only info messages
Msg::showInfo();

// With message format
Msg::showInfo($foo, ':key message: :message!');

// Show all messages in same request
Msg::instant();

// Only info with format
Msg::showInfoInstant($foo, ':key message: :message!');

// Custom group with format
Msg::showExitInstant($bar, ':key message: :message!');

Templates

// Add default template for all groups
Msg::setTemplate('myTemplate');

// Assign template to the specific group
Msg::setTemplates('info', 'myInfoTemplate');

// Assign Laravel Blade string like template
$blade = '

';
$blade .= '@foreach ($messages as $message)';
$blade .= '{{ $message }}';
$blade .= '@endforeach';
$blade .= '

';

Msg::setTemplates('info', $blade, true);

// Delete all templates
Msg::deleteTemplates();

// Delete specific group template
Msg::deleteTemplates('danger');

Examples

// Add and show message instantly
echo Msg::danger('Something is wrong')->showDangerInstant();

// Set group format
Msg::setGroupFormat('info', '<b>:message</b>');

// Get raw messages data
Msg::getMessages();

// Set display mode single or group
Msg::setDisplayMode('single');