Download the PHP package swiftmade/laravel-sendgrid-notification-channel without Composer

Allows you to send Laravel notifications using Sendgrid's Dynamic Transactional Templates feature.

• Minimum Laravel version required: 7.x
• Minimum PHP version required: 7.2

(For older versions of Laravel, install v1)

Contents

• Installation
• Usage
• Changelog
• Testing
• Security
• Contributing
• Credits
• License

Installation

To get started, you need to require this package:

The service provider will be auto-detected by Laravel. If you've turned auto-discovery off, add the following service provider in your config/app.php.

Next, make sure you have a valid Sendgrid API key in config/services.php. You may copy the example configuration below to get started:

Usage

To send an email using dynamic templates, you need to:

1. Return SendGridChannel::class in the via() method. (Not mail)
2. Add and implement the toSendGrid($notifiable){ } method.

Example:

toSendGrid method will receive a $notifiable entity and should return a NotificationChannels\SendGrid\SendGridMessage instance.

💡 Unless you set it explicitly, the From address will be set to config('mail.from.address') and the To value will be what returns from $notifiable->routeNotificationFor('mail');

Sandbox Mode

The sandbox mode is off by default. You can use the setSandboxMode($bool) method to enable/disable it.

Example:

When making a request with sandbox mode enabled, Sendgrid will validate the form, type, and shape of your request. No email will be sent. You can read more about the sandbox mode here.

Attachments

You can attach or embed (inline attachment) files to your messages. SendGridMessage object exposes the following methods to help you do that:

• attach($file, $options)
• attachData($data, $name, $options)
• embed($file, $options)
• embedData($data, $name, $options)

Good to know:

• While using attachData and embedData you must always pass the mime key in the options array.
• You can use the as key in the options to change the filename to appears in the email. (e.g. attach($file, ['as' => 'invoice-3252.pdf']))
• embed and embedData methods will return the ContentID with cid: in front (e.g. embed('avatar.jpg') -> "cid:avatar.jpg").

Full Access to the Sendgrid Mail Object

If you need more customization options, you can work directly with the underlying Sendgrid Mail object. To utilize this, simply pass a callback using the customize method.

For all the options, you can see Sendgrid's Mail class here.

Accessing SendGrid Response

After the notification is sent, Laravel will emit Illuminate\Notifications\Events\NotificationSent event. You can listen to this event to get the SendGrid response object and/or message ID.

Changelog

Please see CHANGELOG for more information what has changed recently.

Testing

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Contributing

Please see CONTRIBUTING for details.

Credits

• swiftmade
• cuonggt
• All Contributors

License

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