spatie / laravel-notification-log by spatie

Log notifications sent by your Laravel app
242,622
183
3
Package Data
Maintainer Username: spatie
Maintainer Contact: freek@spatie.be (Freek Van der Herten)
Package Create Date: 2023-02-23
Package Last Update: 2024-08-16
Home Page: https://spatie.be/docs/laravel-notification-log
Language: PHP
License: MIT
Last Refreshed: 2024-12-17 03:10:04
Package Statistics
Total Downloads: 242,622
Monthly Downloads: 27,589
Daily Downloads: 1,243
Total Stars: 183
Total Watchers: 3
Total Forks: 15
Total Open Issues: 0

Log notifications sent by your Laravel app

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

This package will log all the notifications sent by your app. This will allow you to write logic based on the notifications your app has sent.

If you want to create a list of all notifications sent to a user

// returns a collection of `NotificationLogItem` models
$sentNotifications = $user->loggedNotifications();

In a view, you could write this:

<ul>
@foreach($sentNotifications as $sentNotification)
    <li>{{ $sentNotification->type }} at {{ $sentNotification->created_at->format('Y-m-d H:i:s') }}</li>
@endforeach
</ul>

The package also contains handy methods that allow you to make decisions based on the notifications sent. Here's an example, where we use the wasAlreadySentTo method provided by the package in a shouldSent method of a notification.

// in a notification

public function shouldSend($notifiable)
{
      return ! $this
        ->wasAlreadySentTo($notifiable)
        ->inThePastMinutes(60);
}

You can fully customize which notifications get logged and how they get logged.

Support us

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.

Documentation

All documentation is available on our documentation site.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.