Allow for Dynamic Templates Implementation

[mwillbanks]

Fixes #648

Checklist

• I have made a material change to the repo (functionality, testing, spelling, grammar)
• I have read the [Contribution Guide] and my PR follows them.
• I updated my branch with the master branch.
• I have added tests that prove my fix is effective or that my feature works
• I have added necessary documentation about the functionality in the appropriate .md file
• I have added in line documentation to the code I modified

Short description of what this PR does:

• Adds dynamic template support by adding a new helper object, new methods into the mail and personalization classes.

[SendGridDX]

All committers have signed the CLA.

[thinkingserious]

Thank you @mwillbanks!

[thinkingserious]

cc @martijnmelchers

[jideokus]

Hi. Thanks for working on this. Any news on this?

[mwillbanks]

@jideokus I'm actually using my branch with these changes in production right now. It works pretty much the exact same way as substitutions except that you can use anything as a parameter that is JSON Serializable.

$mail->addDynamicTemplateData('arrayData', ['one', 'two', 'three']);
$mail->addDynamicTemplateData('number', 1);
$mail->addDynamicTemplateData('boolean', true);
$mail->addDynamicTemplateData('string', 'foo');

[jideokus]

Excellent. Thanks @mwillbanks. I'll take it for a spin. I have a bunch of emails waiting to be fired with this 😁

[thinkingserious]

Hello @mwillbanks,

Thanks again for the PR!

We want to show our appreciation by sending you some swag. Could you please fill out this form so we can send it to you? Thanks!

Team SendGrid DX

[thinkingserious]

Here is the final diff.

[iamlucianojr]

Hi, first of all, thanks @mwillbanks for your contribution!

I want to fetch all created templates from the API using as the example shows

sendgrid-php/examples/templates/templates.php

Line 34 in 7ed980a

$response = $sg->client->templates()->get();

But I guess this PR does not cover that point, did it?

[thinkingserious]

@Luciano-Jr,

Please try the following:

<?php
require 'vendor/autoload.php'; // If you're using Composer (recommended)
// Comment out the above line if not using Composer
// require("<PATH TO>/sendgrid-php.php");
// If not using Composer, uncomment the above line and
// download sendgrid-php.zip from the latest release here,
// replacing <PATH TO> with the path to the sendgrid-php.php file,
// which is included in the download:
// https://github.com/sendgrid/sendgrid-php/releases

$apiKey = getenv('SENDGRID_API_KEY');
$sg = new \SendGrid($apiKey);
$query_params = json_decode('{"generations": "dynamic,legacy"}');
$response = $sg->client->templates()->get(null, $query_params);
print $response->statusCode() . "\n";
print $response->body() . "\n";
print_r($response->headers());

With Best Regards,

Elmer