nova-notifications
nova-notifications copied to clipboard
A Laravel Nova tool overview and handle Laravel Notifications
:warning: Note: This repo is not maintained right now.
A Laravel Nova Tool for Handling Laravel Notifications
With this Nova tool:
- You can overview all sent and failed notifications.
- You can send out notifications. (depening on the notification's dependencies)
- All sent or failed notifications will be stored in the database.
Requirements
In order to use this package, you need to have an installation of Laravel with Laravel nova setup.
Installation
First install the Nova package via composer:
composer require christophrumpel/nova-notifications
Then publish the config file(optional):
php artisan vendor:publish --provider="Christophrumpel\NovaNotifications\ToolServiceProvider"
In there, you can define where to look for the Notification classes, as well as the notifiable models.
<?php
return [
/*
* The namespaces you want to check for Notification classes.
*/
'notifiableNamespaces' => [
'App',
],
/*
* The namespaces you want to check for Notifiable classes.
*/
'notificationNamespaces' => [
'App\Notifications',
'Illuminate',
],
];
Next up, you must register the tool via the tools
method of the NovaServiceProvider
.
// inside app/Providers/NovaServiceProvder.php
// ...
public function tools()
{
return [
// ...
new \Christophrumpel\NovaNotifications\NovaNotifications()
];
}
You also need to run php artisan migrate
on your Laravel application so that the new notifications table will be created.
Usage
After installing the tool, you should see the new sidebar navigation item for Notifications
.
Overview
On the Overview
page you can see all of the sent and failed notifications. This only works for notifications sent after installing this package.
Usually, only the notifications sent through the database
channel will be stored in the database. This package comes with a new nova_notifications
table, where all
of them get stored.
Send
On the Send
page you can see all of your created notification classes.
If you don't see a newly created notification class, try running composer dump-autoload
.
Parameters
Since you notifications often depend on parameters, this package tries to help you with that. All found constructor parameters will be shown when you try to send a notification. If one of the dependencies is an Eloquent Model, you will get a list with all of the items to choose from.
If you want to create a new notification with custom objects, then this approach will not work for now. If you have a custom use-case, let me know about it, and we can think of a solution.
Testing
phpunit tests
Changelog
Please see CHANGELOG for more information on what has changed recently.
Security
If you discover any security-related issues, please email me at [email protected] instead of using the issue tracker.
License
The MIT License (MIT).