orchestra/messages

Messages Component for Laravel and Orchestra Platform

Messages Component for Laravel and Orchestra Platform

Messages Component bring a unified notification support for Laravel and Orchestra Platform., _(*1)

, _(*2)

Table of Content

• Version Compatibility
• Installation
• Configuration
• Usage
  • Adding a Message
  • Extending a Message to Current Request
  • Displaying the Message in a View
• Changelog

Version Compatibility

Installation

To install through composer, run the following command from terminal:, _(*3)

composer require "orchestra/messages"

Configuration

Add Orchestra\Messages\MessagesServiceProvider service provider in config/app.php., _(*4)

'providers' => [

    // ...

    Orchestra\Messages\MessagesServiceProvider::class,
],

Aliases

You might want to add Orchestra\Support\Facades\Messages to class aliases in config/app.php:, _(*5)

'aliases' => [

    // ...

    'Messages' => Orchestra\Support\Facades\Messages::class,
],

Usage

Adding a Message

Adding a message is as easy as following:, _(*6)

Messages::add('success', 'A successful message');

You can also chain messages:, _(*7)

Messages::add('success', 'A successful message')
    ->add('error', 'Some error');

Extending a Message to Current Request

There might be situation where you need to extend a message to the current response instead of the following request. You can do this with:, _(*8)

Messages::extend(function ($message) {
    $message->add('info', 'Read-only mode');
});

Displaying the Message in a View

Here's an example how you can display the message:, _(*9)

<?php

$message = Messages::copy();

if ($message instanceof Orchestra\Messages\MessageBag) {
    $message->setFormat('

:message

');

    foreach (['error', 'info', 'success'] as $key) {
        if ($message->has($key)) {
            echo implode('', $message->get($key));
        }
    }
}