Skip to content

Commit

Permalink
Merge pull request #33 from mailjet/development
Browse files Browse the repository at this point in the history
Development
  • Loading branch information
goshon authored Feb 19, 2019
2 parents cbe0fb1 + dee3440 commit a609996
Show file tree
Hide file tree
Showing 263 changed files with 41,578 additions and 2,074 deletions.
118 changes: 37 additions & 81 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
drupal-mailjet-module-apiv3
Mailjet for Drupal 7.x module
===========================

Mailjet APIv3 module for Drupal
Expand Down Expand Up @@ -28,8 +28,7 @@ Requirements

Recommended modules
-------------------
The following modules are not strictly required but it is nice to install them to get
the full capability of the Mailjet features.
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)
Expand All @@ -55,10 +54,8 @@ http://github.com/PHPMailer/PHPMailer/archive/v5.2.22.zip
2) Extract the archive and rename the folder "PHPMailer-5.2.22" to "phpmailer".
3) Upload the "phpmailer" folder to your server inside
DRUPAL_ROOT/sites/all/libraries/.
4) 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.
4) 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.

Installation
------------
Expand All @@ -69,66 +66,21 @@ Installation
4. Enable the Mailjet settings module on the Administration > Modules page.
5. Fill in required settings on the Administration > Configuration > Mailjet
settings page.
6. You will be required to enter API key and Secret Key from your Mailjet account.
If you do not have an account yet, please [create one](https://app.mailjet.com/signup?aff=drupalmj).
6. You will be required to enter API key and Secret Key from your Mailjet account. If you do not have an account yet, please [create one](https://app.mailjet.com/signup?aff=drupalmj).

Configuration
-------------

1. 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.
2. 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)
3. 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).
4. 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.
5. 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”.
6. 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.
7. My account menu item will redirect you to the mailjet logging page.
8. Upgrade menu link will redirect you to the pricing list of mailjet where
you can pick up a plan and upgrade your account.
9. 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.
10. 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
1. 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.
2. If you want to enable the Campaign feature, you should enable the mailjet_campaign module, you can do that from Administration > Site building > Modules page (your_site/admin/modules)
3. 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).
4. 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 app.mailjet.com.
5. If you want to create a campaign simply go to the Campaigns page => your_site/admin/mailjet/campaign
6. 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 stats you 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.
7. My account menu item will redirect you to the Mailjet logging page.
8. Upgrade menu link will redirect you to the pricing list of Mailjet where you can pick up a plan and upgrade your account.
9. The contacts menu item allows you to create lists that can be used for your campaigns. New lists can be created and contacts can be import in several ways: Upload from CSV, Copy/Paste from Excel, Copy/Paste from TXT, CSV, RTF.
10. 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

Author
------
Expand All @@ -137,42 +89,46 @@ [email protected]

Changelog
---------
= 7.x-2.18 6 June 2018 =
#### 7.x-2.19 18 February 2019
* Bugfixes and internal improvements regarding contacts sync, subscription and unsibscription of contacts
* Updated texts and translations

#### 7.x-2.18 6 June 2018
* Fix issue when Stats module enabled and Campaign module disabled
* Fix "Send emails through Mailjet" unchecked overrides non-default Mail system
* Fix redirecting regular users to the Mailjet Settings
* Add config setting for user property syncing
* Fix subscription form issue
* Fix an issue if campaings module is not installed

= 7.x-2.17 17 April 2018 =
#### 7.x-2.17 17 April 2018
* Update the tracking parameter

= 7.x-2.16 5 December 2017 =
#### 7.x-2.16 5 December 2017
* New feature: added creation of a subscription block
* Various bugfixes and improvements

= 7.x-2.15 16 October 2017 =
#### 7.x-2.15 16 October 2017
* Bug fix: The callback parameter is temporarily removed

= 7.x-2.14 1 June 2017 =
#### 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 =
#### 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 =
#### 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 =
#### 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
Expand All @@ -181,33 +137,33 @@ 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 =
#### 7.x-2.10 25 Jan 2017
* Bug fix: https://www.drupal.org/node/2842760

= 7.x-2.9 11 Jan 2017 =
#### 7.x-2.9 11 Jan 2017
* Feature: update PHPmailer library
https://www.drupal.org/node/2842760

= 7.x-2.7 25 Oct 2016 =
#### 7.x-2.7 25 Oct 2016
* Bug fixes

= 7.x-2.6 12 Feb 2016 =
#### 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 =
#### 7.x-2.5 8 Oct 2015
* Added tracking information

= 7.x-2.4 3 Aug 2015 =
#### 7.x-2.4 3 Aug 2015
* Added iFrame parameter to show/hide sending policy

= 7.x-2.3 8 May 2015 =
#### 7.x-2.3 8 May 2015
* Bug fixes

= 7.x-2.2 8 Apr 2015 =
#### 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 =
#### 7.x-2.1 24 Mar 2015
#### 7.x-2.0 17 Mar 2015
* First release of the new version of the Mailjet module
46 changes: 46 additions & 0 deletions composer.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
{
"name": "mailjet/drupal-mailjet-module-apiv3",
"type": "drupal-module",
"description": "Mailjet Drupal 7 integration",
"keywords": ["Drupal"],
"license": "GPL-2.0+",
"homepage": "https://www.drupal.org/project/mailjet",
"minimum-stability": "dev",
"support": {
"issues": "https://www.drupal.org/project/issues/mailjet",
"source": "http://cgit.drupalcode.org/mailjet"
},
"repositories": [
{
"type": "vcs",
"url": "[email protected]:mailjet/mailjet-apiv3-php.git"
},
{
"type": "vcs",
"url": "[email protected]:mailjet/Mailjet-iframe-v3.git"
}
],
"require": {
"phpmailer/phpmailer": "~5.2",
"mailjet/mailjet-apiv3-php": "dev-master",
"mailjet/Mailjet-iframe-v3": "dev-master"
},
"autoload": {
"psr-4": {
"MailjetTools\\": "src/MailjetApi/"
}
},
"config": {
"preferred-install": "dist"
},
"scripts": {
"post-install-cmd": [
"find ./vendor -name '.git' | xargs rm -rf",
"find ./vendor -name '.gitignore' | xargs rm -rf"
],
"post-update-cmd": [
"find ./vendor -name '.git' | xargs rm -rf",
"find ./vendor -name '.gitignore' | xargs rm -rf"
]
}
}
Loading

0 comments on commit a609996

Please sign in to comment.