A module to assist developers in sending template emails via SendGrid
- silverstripe/framework: ^4.0
composer require vulcandigital/silverstripe-sendgridmysite/_config/sendgrid.yml:
Vulcan\SendGrid\SendGrid:
api_key: 'REPLACE-WITH-YOUR-API-KEY'$sendGrid = \Vulcan\SendGrid\SendGrid::create();
$sendGrid->setSubject("We have a sale for you!");
$sendGrid->setFrom('[email protected]');
$sendGrid->setFromName('My Site');
$sendGrid->setReplyTo('[email protected]');
$sendGrid->addRecipient('[email protected]', 'Reece Alexander', [
':salutation' => 'Mr',
':button_link' => 'https://example.com/store/offer?id=aASdGdjnklashewjk12321hjkasd213'
]);
$sendGrid->setBody("<p>We thought you'd like this awesome t-shirt!</p>");
$sendGrid->setTemplateId('your-template-id');
$sendGrid->addAttachment(Image::get()->first());
$sendGrid->send();You can add as many recipients as you want.
Substitutions and custom arguments are practically the same thing, the only difference is that custom arguments are applied globally regardless of the recipient where substitutions are variable replacements that can differ per recipient.
Substitutions will always override any custom argument
Substitutions are variables that can be replaced per recipient
$sendGrid->addRecipient('[email protected]', 'John Doe', [
':salutation' => 'Mr',
':first_name' => 'John',
':last_name' => 'Doe'
]);
$sendGrid->addRecipient('[email protected]', 'Jane Doe', [
':salutation' => 'Mrs',
':first_name' => 'Jane',
':last_name' => 'Doe'
]);Custom arguments are applied globally across all recipients unless a substitution has overridden it
$sendGrid->addCustomArg(':year', DBDatetime::now()->Year());You can add as many attachments as you want totalling up to 30 MB. The attachment must be a File object or a subclass of it such as itself or Image.
$file = Image::get()->first();
$sendGrid->addAttachment($file, $filename = null, $forcePublish = false); or you can use an absolute path to a file instead:
$sendgrid->addAttachment('/public_html/path/to/image.png'));
$sendgrid->addAttachment(Controller::join_links(Director::baseFolder(), '/path/to/image2.png'));If you provide $filename, make sure you provide the correct extension as well to prevent any errors
If the provided file is a File object and $forcePublish is set to true and the File you have provided has not been published, it will be forcibly published.
You can schedule emails to be sent at a later date:
$sendGrid->setScheduleTo(DBDatetime::now()->getTimestamp() + 3600); // Schedule to send in 1 hourImportant: Ensure that you have specified your correct timezone in your SendGrid account's settings, otherwise this may have unexpected results.
Your database timezone should also match the timezone you have specified in your account. See Core Environment Variables for information on how to modify the timezone used by your database.
It is always advised when dealing with dates and times in SilverStripe to use the functionality it has provided you as shown in the example above.
$sendGrid->setSandboxMode(true);If everything is OK, $sendGrid->send() will return true otherwise an error will be thrown.