luyadev/luya-mailjet

LUYA and Yii Framework integration for mailjet service.

LUYA Mailjet

LUYA and Yii Framework integration for Mailjet service.

Contains:

• Yii Framework BaseMailer for Transaction E-Mails trough API.
• Interface for Subscription Mail Sync including CLI command for Synchronisation.
• A PHP library to convert MJML content into Mailjet Passport json format.
• LUYA Admin Module to convert MJML into HTML based on MJML.io API.
• LUYA Active Window to retrieve informations about a given User E-Mail.
• A Widget to subscribe to a List with double opt in (can be disabled).
• SMS Sending helpers
• Yii 2 Queue Job to send mails with a template

Installation

Install the extension through composer:

composer require luyadev/luya-mailjet

Add to config:

'components' => [
    //...
    'mailjet' => [
        'class' => 'luya\mailjet\Client',
        'apiKey' => '...',
        'apiSecret' => '...',
    ],
    'mailer' => [
        'class' => 'luya\mailjet\Mailer',
    ],
]

Basic Send Mail

Sending transactional E-Mail:

Yii::$app->mailer->compose()
    ->setFrom('[email protected]')
    ->setTo('[email protected]')
    ->setSubject('Message subject')
    ->setTextBody('Plain text content')
    ->setHtmlBody('<b>HTML content</b>')
    ->send();

Send a transactional E-Mail based on the Template id stored in Mailjet:

Yii::$app->mailer->compose()
    ->setTemplate(484590)
    ->setVariables(['lastname' => 'Lastname Value'])
    ->setTo(['[email protected]'])
    ->send();

MJML to HTML

With version 1.3 of LUYA Mailjet library there is an admin module you can configured in order to parser MJML into HTML, therefore add the module to your configuration and provide mjml.io API keys:

'modules' => [
    //...
    'mailjetadmin' => [
        'class' => 'luya\mailjet\admin\Module',
        'mjmlApiApplicationId' => 'ApplicationIdFromMjml.io',
        'mjmlApiSecretKey' => 'ApplicationSecretFromMjml.io',
    ]
]

Afterwards you can retrieve and render the HTML of MJML template with:

luya\mailjet\models\Template::renderHtml('slug', ['foo' => 'bar']);

luya-mailjet's Issues

mjml parser

added new options to

• parse the mjml to html ON Request, instead while saving
• option to parse the variables within the mjml content instead of html

(@rolandschaub)

Error when setting "defaultTemplateErrorReporting" without templates

'mailer' => [
    'class' => 'luya\mailjet\Mailer',
    'defaultTemplateErrorReporting' =>'[email protected]',
],

'forms' => [
    'class' => 'luya\forms\Forms',
    'emailMessage' => function (SubmissionEmail $email, Forms $form) {
        // your custom mailer integration is here, ensure to return a boolean
        // value whether sending was successfull or not!    
        $x = \Yii::$app->mailer->compose()
            ->setTo($email->getRecipients())
            ->setSubject($email->getSubject())
            ->setTextBody(strip_tags($email->getSummaryHtml()))
            ->setHtmlBody($email->getSummaryHtml())
            ->send();

        var_dump(\Yii::$app->mailer->lastError);
        exit;
    }
]

Error message

string(1293) "array (
  'Messages' => 
  array (
    0 => 
    array (
      'Status' => 'error',
      'Errors' => 
      array (
        0 => 
        array (
          'ErrorIdentifier' => '74d2cbc4-df26-4f7e-94e9-d13110a588bb',
          'ErrorCode' => 'send-0016',
          'StatusCode' => 400,
          'ErrorMessage' => '"TemplateLanguage" is not set while "TemplateErrorReporting" or "TemplateErrorDeliver" properties are.',
          'ErrorRelatedTo' => 
          array (
            0 => 'TemplateLanguage',
            1 => 'TemplateErrorDeliver',
            2 => 'TemplateErrorReporting',
          ),
        ),
      ),
    ),
  ),
) | array (
  'Messages' => 
  array (
    0 => 
    array (
      'Status' => 'error',
      'Errors' => 
      array (
        0 => 
        array (
          'ErrorIdentifier' => '74d2cbc4-df26-4f7e-94e9-d13110a588bb',
          'ErrorCode' => 'send-0016',
          'StatusCode' => 400,
          'ErrorMessage' => '"TemplateLanguage" is not set while "TemplateErrorReporting" or "TemplateErrorDeliver" properties are.',
          'ErrorRelatedTo' => 
          array (
            0 => 'TemplateLanguage',
            1 => 'TemplateErrorDeliver',
            2 => 'TemplateErrorReporting',
          ),
        ),
      ),
    ),
  ),
) | 'Bad Request'"