hot-tip-notification-when-method.md

Notification when() method

When sending notifications with Laravel, there's a when() method on each message type that can be used to optionally add lines or actions when some value is true. Very similar concept the the when method on the QueryBuilder and Collections.

Query Builder Example

Team::when(request()->has('filters.name'), function ($query) {
    $q->where('name', request('filters.name'));
})->get();

Notification Example

<?php

// ...

class ExampleNotification extends Notification
{
    // ...
    
    public function toMail($notifiable)
    {
        return (new MailMessage)
                    ->greeting('Hello world')
                    ->when($this->team->isOnFreePlan(), function ($message) {
                        $message->action('Upgrade', );
                    });
    }
}