https://github.com/jalle19/laravel-unshitty-flash

Highly opinionated flash message service for Laravel
https://github.com/jalle19/laravel-unshitty-flash

Last synced: about 2 months ago
JSON representation

Highly opinionated flash message service for Laravel

• Host: GitHub
• URL: https://github.com/jalle19/laravel-unshitty-flash
• Owner: Jalle19
• License: mit
• Created: 2017-04-05T07:38:27.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2017-04-05T19:06:35.000Z (over 7 years ago)
• Last Synced: 2024-10-12T13:26:18.062Z (3 months ago)
• Language: PHP
• Homepage:
• Size: 16.6 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# laravel-unshitty-flash

[![Build Status](https://travis-ci.org/Jalle19/laravel-unshitty-flash.svg?branch=master)](https://travis-ci.org/Jalle19/laravel-unshitty-flash) 

[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/Jalle19/laravel-unshitty-flash/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/Jalle19/laravel-unshitty-flash/?branch=master) 

[![Coverage Status](https://coveralls.io/repos/github/Jalle19/laravel-unshitty-flash/badge.svg?branch=master)](https://coveralls.io/github/Jalle19/laravel-unshitty-flash?branch=master)

Highly opinionated flash message service for Laravel. In contrast to practically all other similar libraries I've seen, 

this one:

* Supports multiple messages

* Supports multiple identical messages

* Supports flashing immediately, i.e. to the current request

* Let's you configure the session key used

* Forces you to inject the service, no magic facade

* Forces you to operate on the `Request` object itself

## Installation

Install the package:

```bash

composer require jalle19/laravel-unshitty-flash

```

Register the service provider:

```php

'providers' => [

	...

	Jalle19\Laravel\UnshittyFlash\FlashServiceProvider::class,

	...

]

```

Publish the configuration file:

```bash

php artisan vendor:publish --provider="Jalle19\Laravel\UnshittyFlash\FlashServiceProvider"

```

## Usage

Inject `FlashService` into the controller you want to create flash messages from, then use it like this:

```php

$this->flashService->success($request, 'Some successful message');

$this->flashService->info($request, 'Some informational message');

$this->flashService->warning($request, 'Some warning');

$this->flashService->danger($request, 'Some dangerous message');

```

If you need to flash a message to the current request, (e.g. from a middleware that displays a permanent message), pass 

`true` as the third parameter:

```php

$this->flashService->info($request, 'Permanently visible message', true);

```

If the message levels above are not enough for you, you can use an arbitrary level using the `message()` method:

```php

$this->flashService->message($request, 'Some rant about libraries', 'rant');

```

To render the flash messages in your views, you can use something like the following snippet:

```blade

@foreach (session()->get(config('flash.session_key'), []) as $notification)

    


        ×


        {!! $notification['message'] !!}

    
    

@endforeach

```