Download the PHP package flavorly/inertia-flash without Composer
On this page you can find all versions of the php package flavorly/inertia-flash. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download flavorly/inertia-flash
More information about flavorly/inertia-flash
Files in flavorly/inertia-flash
Package inertia-flash
Short Description A Quick way to flash & share InertiaJS Variables from anywhere, persisting on session.
License MIT
Homepage https://github.com/flavorly/inertia-flash
Informations about the package inertia-flash
Inertia Flash ⚡
A Quick way to flash & share variables to InertiaJS that persist on session or cache. Really useful for redirects & returns! Sharing to Inertia anywhere :)
Installation
You can install the package via composer:
You can publish the config file with:
This is the contents of the published config file:
1) Inertia Share
You can use the Inertia Flash helper anywhere from your code and share your variables directly to InertiaJS. Keep in the mind that the values will only be kept on the current or next request lifecycle, they will be flushed once shared to Inertia You may also use closures that under-the-hood will be converted to Laravel Closure Serializer ( Previously Opis )
2) Notifications
This package also provide a nice way to build a agnostic notification system that can be shared to Inertia or Other Frameworks
Here is a basic example of usage:
2.1) Notifications Channels
The Package provides 4 different ways to forward notifications, here is a quick breakdown:
- Via Inertia - This will share the notification to frontend, resulting in a property being injected on the shared data, by default it goes into "notifications", this can be changed, it will contain an array of notifications there.
- Via Database - This will use Laravel Notifications system to persist the notification on the database
- Via Broadcast - this will use Laravel Echo to broadcast the notification to the frontend
- Via Mail - this will use Laravel Mail to send the notification to the user
Keep in mind that you can always override all this channels & the notification yourself by extending the original notification class or providing one on the configuration, Please do check the config.php
for more information
2.2) Notifications Content Blocks
Usually notifications contain a title, message & icon, but there is some cases where you want more, we provide a simple abstraction for simple content blocks This is useful for Dialogs, where you want to show more information, keep in mind this is really simple, anything more complex should be taken care on the frontend
Here is a quick example
2.3) Notifications Icon
By default the notification doesnt contain any icon, we send a "level" back, so you can decide on the frontend how you will handle the icon based on the level But you can also pass in more complex icons or raw icons ( say emojis ) for the notification icon.
2.4) Notifications Levels & Types
By default a level info
and type flash
is set, you can change this by calling fluent methods.
Different types of notifications can usefull across the app, while Flash notifications are more useful to show quick messages, dialogs can be also useful to show more detailed information.
2.5) Notifications Advanced
There is a lot more to explore on the notifications advanced options, so im going to highlight some of them here:
- Calling
dispatch()
will usually "queue" the notification sending depending on your driver, calldispatchNow()
to send it immediately - Queues & Connections can be configured in the config file, same structure as Laravel.
- By default no channels are enabled, you can chain
viaInertia()
,viaDatabase()
,viaBroadcast()
,viaMail()
to enable them, or use the configuration to set a default channel. - By default, when using Broadcast or Database, we will try to resolve the notified to the current logged user, but you can always use
toUser()
orto($notifiable)
to send it to a specific user/model. - When using Database Notifications a URL for
readable
is generated, you can override this by callingreadable($url)
on the notification. - You can also use
readable()
to generate a URL based on the current request. - There is a current issue that when sharing with Inertia & Database Notifications, the notification will be shared to the frontend, the ID of the inertia notification is a auto-generated one since the record is only created later. Use a Listener to update or just use Broadcast
2.6) Notifications Frontend Implementation
Here is an example of a component using Shadcn for Flash notifications, supporting emojis, icons and iconify for icons.
React Example:
`
Why Inertia Flash?
This package is intended to be used with the InertiaJS framework. Inertia provides a nice way to share variables, but sometimes you might want to share data from somewhere else in your code.
Few use cases :
- Sharing data before a redirect ( Ex: back()->with('foo','bar') can be replicated with back()->inertia('foo','bar') )
- Sharing data from a controller to a view without using Inertia::share()
- Sharing data from a service directly
- Sharing data from any point of your code before serving a request/page
- Sharing data from a command/job to a specific user
- Avoiding Inertia Middleware pollution with sharing session variables back and forth.
- etc..
If you are looking for real-time sharing this package might not be your best choice, and would recommend using Laravel Echo paired together with Pusher or Soketi.
Testing
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- jon
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of inertia-flash with dependencies
laravel/framework Version ^v11.0.0
illuminate/contracts Version ^11.8.0
spatie/laravel-data Version ^4.5
spatie/laravel-package-tools Version ^1.16