Laravel Relevance Ensurer

0.4.0 2020-09-09 08:46 UTC

This package is auto-updated.

Last update: 2022-05-09 12:30:26 UTC


Laravel Relevance Ensurer

Laravel Relevance Ensurer provides an easy way not to process notifications and jobs which became irrelevant.


You can install this package via composer using this command:

composer require coderello/laravel-relevance-ensurer


Let's assume we are a meetup organizing platform. And we have to remind all participants of the meetup 48 hours before it starts.

Huh, looks like it is easy. Few lines of code.

    (new MeetupReminder($meetup))

But what if the user leaves the meetup? In this case, we should prevent the notification from being sent.

Here Laravel Relevance Ensurer comes to help.

The only thing we need to do is to implement ShouldBeRelevantNotification contract on the notification. It comes with one public method isRelevant($notifiable) which should return bool representing relevance of the notification before one is sent.

Let's take a look at an example:


namespace App\Notifications;

use Illuminate\Bus\Queueable;
use Illuminate\Notifications\Notification; 
use Illuminate\Contracts\Queue\ShouldQueue;
use Coderello\RelevanceEnsurer\Contracts\ShouldBeRelevantNotification;
use App\Models\Meetup;
use Illuminate\Queue\SerializesModels;

class MeetingReminder extends Notification implements ShouldQueue, ShouldBeRelevantNotification
    use Queueable, SerializesModels;

    public $meetup;

    public function __construct(Meetup $meetup)
        $this->meetup = $meetup;

    public function isRelevant($notifiable): bool
        return $this->meetup->users()->where('id', $notifiable)->exists();

    public function toMail($notifiable)
        // returns the mail representation of the notification

So if the notification is relevant, it'll be sent and vice versa.

Almost the same contract exists for jobs. The only difference is that ShouldBeRelevantJob's isRelevant() method doesn't accept any arguments.


Please see CONTRIBUTING for details.


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