YiiSendGrid is an application component used for sending email through sendgrid.
It's a wrapper for SendGrid php library
You may configure it as below. Check the attributes of YiiSendGrid class and YiiSendGridMail class for more options.
- PHP 5.3+
Download the file and extract to protected/extensions (or anywhere you like, but then adjust the example accordingly)
Add the component to your configuration file (usually protected/configs/main.php) as below:
return array(
'components' => array(
//...
'sendgrid' => array(
'class' => 'ext.yii-sendgrid.YiiSendGrid', //path to YiiSendGrid class
'username'=>'myUsername', //replace with your actual username
'password'=>'myP4s$w0rd', //replace with your actual password
//'viewPath' => 'application.views.mail', //alias to the layouts path. Optional
//'enableLog' => YII_DEBUG, //wheter to log the emails sent. Optional
//'dryRun' => false, //if enabled, it won't actually send the emails, only log. Optional
//'disableSslVerification'=>true,//ignore verification of SSL certificate
),
//...
)
);
Examples
$message = Yii::app()->sendgrid->createEmail();
//shortcut to $message=new YiiSendGridMail($viewsPath);
$message->setHtml('<p>Message content here with HTML</p>')
->setSubject('My Subject')
->addTo(array('johnDoe@domain.com'))
->setFrom('myemail@mydomain.com');
Yii::app()->sendgrid->send($message);
or just
$message = Yii::app()->sendgrid->createEmail($htmlBody,$subject,$to,$from);
Yii::app()->sendgrid->send($message);
A more real life and complete example using a view and optionally a layout
$message = Yii::app()->sendgrid->createEmail();
//set view variable $user
$message
->setView('signup') //view located in YiiSendGrid::$viewPath. Defaults to protected/views/mail
->setHtml(array(
'user'=>$user//my User model. Pass it to the view as $user, same way controller does
));
// optionally you can use a layout
//$message->layout='application.views.layouts.email';
$message
->setSubject('Welcome to '.Yii::app()->name.'!')
->addTo(array($user->email))
->setFrom(Yii::app()->params['adminEmail']);
//handle errors
if(!Yii::app()->sendgrid->send($message))
{
Yii::log("Failed to send email:\n".print_r(Yii::app()->sendgrid->lastErrors,true),CLogger::LEVEL_ERROR);
}