Mailjet APIv3 module for Drupal
This module for Drupal 7.x. provides complete control of Drupal Email settings with Mailjet and also adds specific Drupal Commerce email marketing functionality such as triggered marketing emails and marketing campaign revenue statistics.
The Mailjet Module for Drupal 7.x configures your default Drupal SMTP settings to use Mailjet's SMTP relay with enhanced deliverability and tracking. The module also provides the ability to synchronise your Drupal opt-in contacts and send bulk and targeted emails to them with real time statistics including opens, clicks, geography, average time to click, unsubs, etc.
Mailjet is a powerful all-in-one email service provider used to get maximum insight and deliverability results from both marketing and transactional emails. Our analytics tools and intelligent APIs give senders the best understanding of how to maximize benefits for each individual contact and campaign email after email.
- Views (https://www.drupal.org/project/views)
- Views Bulk Operations (https://www.drupal.org/project/views_bulk_operations)
- Entity (https://www.drupal.org/project/entity)
- Chaos tool suite (ctools) (https://www.drupal.org/project/ctools)
The following modules are not strictly required but it is nice to install them to get the full capability of the Mailjet features.
- commerce (https://www.drupal.org/project/commerce) For the stats sub module to enable the ROI feature install:
- views_date_format_sql (https://www.drupal.org/project/views_date_format_sql)
- charts (https://www.drupal.org/project/charts) For the list module you need to install:
- viewfield (https://www.drupal.org/project/viewfield)
The Mailjet plugin relies on the PHPMailer v5.2.21 for sending emails.
To install PHPMailer via composer use:
composer require phpmailer/phpmailer=~5.2
To install PHPMailer manually:
- Get the PHPMailer v5.2.22 from GitHub here: http://github.com/PHPMailer/PHPMailer/archive/v5.2.22.zip
- Extract the archive and rename the folder "PHPMailer-5.2.22" to "phpmailer".
- Upload the "phpmailer" folder to your server inside DRUPAL_ROOT/sites/all/libraries/.
- Verify that the file class.phpmailer.php is correctly located at this path: DRUPAL_ROOT/sites/all/libraries/phpmailer/class.phpmailer.php
- Note: Libraries API can be used to move the library to an alternative location, if needed, e.g. for use in a distribution.
- Download a release from https://www.drupal.org/project/mailjet.
- Upload the module in your Drupal sites/all/modules/ directory.
- Log in as administrator in Drupal.
- Enable the Mailjet settings module on the Administer > Site building > Modules page.
- Fill in required settings on the Administer > Site configuration > Mailjet settings page.
- You will be required to enter API key and Secret Key, if you do not have any, you should go to https://www.mailjet.com/ And signup for your credential data. You should enter those credentials under your API tab (your_site/admin/config/system/mailjet/api).
- The site can be set up to use the mailjet module as an email gateway, this can be easily configured, by clicking on the Settings tab => your_site/admin/config/system/mailjet, and then selecting the checkbox on the top, "Send emails through Mailjet", click "Save Settings" button on the bottom of the page. You can test that feature by sending a test email, just click the button on the top of the page Send test email in Settings tab.
- If you want to enable the Campaign feature, you should enable the mailjet_campaign module, you can do that from Administer > Site building > Modules page (your_site/admin/modules)
- Enabling the campaign sub module will create additional menu item in your administration menu, the new menu is called "Campaign" (your_site/admin/mailjet/campaign).
- Clicking this menu item will display all the campaigns created by the administrator, from this point you will be able to create new campaigns as well, the same way you do that on mailjet.com.
- If you want to create a campaign simply go to the campaign page => your_site/admin/mailjet/campaign On the top right side of the page that will be presented there is a button “Create a campaign”, clicking that button will lead you to a new page presenting a form that needs to be full fill, this is the first out of three steps of creating a new campaign. The following fields are requiered - title of the campaign, language, and contact list that you already created, select your edition mode and click “Save and continue”. In the next step you should enter the “Sender name”, choose template of the email and write your email, if you want you can add links inside the email body(the "TEXT" text area) leading to your site and if a customer click on that link and purchase any product from your site this order will be recorded in the ROI stats feature where you can see how good is your conversion rate, click the “Done” button on the bottom of the email text area, and click “Continue”, in the next step which is the last one you can choose to send the email now or schedule it for later, click “Save and send”.
- If you enable the stats module 2 menu items will appear Dashboard where you can see the results of the mail campaigns and the Mailjet ROI stats, clicking the ROI statsyou can see the actual conversion of your campaigns, this feature will display a view which will present the campaign name, number of orders made by users who clicked on the link of your site in your email campaign.
- My account menu item will redirect you to the mailjet logging page.
- Upgrade menu link will redirect you to the pricing list of mailjet where you can pick up a plan and upgrade your account.
- The contacts menu item allows you to create lists that can be used for your campaigns. If you click on Contacts the list of all contact lists will be displayed on the top right side of the screen a button for creating a new contact list is available => Create a contact list. If you click on the button a short notification from mailjet with some terms will appear if you click the OK button you will be redirected to the creation form of your contacts list. Here you need to enter your list name, choose an import method => Upload from CSV, Copy/Paste from Excel, Copy/Paste from TXT, CSV, RTF. Upload your file and click Create. On the next step you should choose the import type email or mailjet_list_view click create.
- If you want to enable the trigger_examples sub-module you need to enable
the views_bulk_operations module and apply the following patch to it:
https://www.drupal.org/files/issues/views-vbo-patch-anon-users.patch
Mailjet SAS [email protected]
= 7.x-2.15 16 October 2017 =
- Bug fix: The callback parameter is temporarily removed
= 7.x-2.14 1 June 2017 =
- Bug fix: Messages improved
- Bug fix: Validate add domain field
- Bug fix: Unable to synchronize a new user if the Drupal contact list already exists
= 7.x-2.13 6 Mar 2017 =
- Bug fix: Unable to send more than 1 mail per request when using Libraries API in a non default directory https://www.drupal.org/node/2853496
= 7.x-2.12 13 Feb 2017 =
- Feature: Support autoload for PHPMailer https://www.drupal.org/node/2850791
- Bug fix: Fatal error with plugin https://www.drupal.org/node/2753095
- Bug fix: Error when user profile is associated with entity_reference field https://www.drupal.org/node/2491389
= 7.x-2.11 7 Feb 2017 =
- Bug fix: Module breaks site login https://www.drupal.org/node/2491395 https://www.drupal.org/node/2598060
- Bug fix: Call to undefined function mailjet_campaign_access() https://www.drupal.org/node/2597309
- Feature: Add ability to disable user information syncing https://www.drupal.org/node/2663328
= 7.x-2.10 25 Jan 2017 =
- Bug fix: https://www.drupal.org/node/2842760
= 7.x-2.9 11 Jan 2017 =
- Feature: update PHPmailer library https://www.drupal.org/node/2842760
= 7.x-2.7 25 Oct 2016 =
- Bug fixes
= 7.x-2.6 12 Feb 2016 =
- Mailjet event URL is now public Fixed URL path to avoid Drupal redirect
= 7.x-2.5 8 Oct 2015 =
- Added tracking information
= 7.x-2.4 3 Aug 2015 =
- Added iFrame parameter to show/hide sending policy
= 7.x-2.3 8 May 2015 =
- Bug fixes
= 7.x-2.2 8 Apr 2015 =
- Bug fix: not able to display the trusted domain form https://www.drupal.org/node/2456715
= 7.x-2.1 24 Mar 2015 = = 7.x-2.0 17 Mar 2015 =
- First release of the new version of the Mailjet module