Summary

• Introduction
• How to Install the Mailjet Module
• How to Configure the Mailjet Module
• Mailjet Subscription Widget
• Mailjet Contacts
• Mailjet Campaigns
• Mailjet Statistics
• Troubleshooting
• Conclusion

 

Introduction

Joomla is a free and open-source content management system (CMS) for publishing web content. As of November 2016, Joomla! has been downloaded over 81 million times. Over 7,800 free and commercial extensions are available from the official Joomla! Extensions Directory, and more are available from other sources. It is estimated to be the second most used content management system on the Internet, after WordPress.

The Mailjet Joomla extension provides complete control of your Joomla Email service using Mailjet. This includes replacing your default Joomla transactional SMTP service, as well as being a fullstack email marketing solution for your Joomla website. The main features you can take advantage of are:

• Excellent Deliverability thanks to Mailjet’s SMTP relay
• Flexible and easy-to-use Email Design using our drag-and-drop email editor
• Use our Signup Widget to allow your site’s customers to join your contact lists stored on Mailjet
• Easily create and update Contact Lists directly from within the Mailjet Joomla plugin
• Create and send personalized Campaigns
• View sending Statistics
• Take advantage of Premium Features like A/B Testing, Contact Segmentation and Campaign Comparison to improve the effectiveness of your marketing campaigns

In this guide we will provide you with step-by-step instructions on how to install and configure the Mailjet extension, how to activate the subscription widget, as well as guide you through the different Mailjet features and how to best take advantage of them.

 

How to Install the Mailjet Module

The Mailjet extension can either be installed directly from the Joomla admin, or downloaded and then uploaded manually. Below we will explain both methods.

Install from Web

1. In the Joomla Admin, select ‘Extensions’ → ‘Manage’ → ‘Install’.

   

2. In the ‘Install from Web’ tab, search for Mailjet and select the result.

   

3. Click on the ‘Install’ button.

   

4. You will need to confirm your decision by clicking on ‘Install’ once again.

   

5. It will take a short time for the extension to be successfully installed. Once this is done, you will see a confirmation message.

   

Download from Joomla.org

1. Go to the Mailjet extention page in Joomla.

2. Click on the ‘Get Mailjet Email Marketing‘ link to download the extension.

   

3. Go back to the Joomla admin and click on ‘Extensions’ → ‘Manage’ → ‘Install’.

   

4. Go to the ‘Upload Package File’ tab.

   

5. Drag and drop the extension file, or browse through your files in order to find and select it.

   

6. The extension will be installed automatically after you select the file to upload. Once completed, you will see a confirmation message.

   

How to Configure the Mailjet Module

If you do not yet have a Mailjet account, it’s now time to create one! Simply click on the ‘Create your Mailjet account’ link on the Mailjet Settings page or click here to go to Mailjet directly.

Once you have created your Mailjet account, you can find your API (username) and Secret (password) Keys in the API Key Management section. You will need those to link your Mailjet Joomla extension with your actual Mailjet account.

To properly configure the Mailjet extension, you need to edit its settings, as well as the Mail Settings in the Joomla Global Configuration section.

Global Configuration

1. In the Joomla admin, click on ‘System’ → ‘Global Configuration’.

   

2. Go to the ‘Server’ tab.

   

3. You will see the ‘Mail Settings’ section there.

   

   You need to configure the Mail Settings the following way:

   • Send Mail: YES
   • Disable Mass Mail: NO
   • From E-mail: Enter a sender address that has been validated in your Mailjet account
   • From Name: Enter a From name of your choice
   • Mailer: SMTP Server
   • SMTP Host: in-v3.mailjet.com
   • SMTP Port: 465
   • SMTP Security: SSL/TLS
   • SMTP Authentication: YES
   • SMTP Username: Your Mailjet API Key
   • SMTP Password: Your Mailjet Secret Key

4. Once you have successfully entered the details, click on ‘Save’ to submit the information.

   

5. You can also test the settings by clicking on the ‘Send Test Email’.

   

   A test email will be sent from the ‘From Email’ address you have selected, to the same email address. If the configuration is incorrect, an email will not be sent at all.

Mailjet Settings

1. In the Joomla admin, click on ‘Components’ → ‘Mailjet’ → ‘Settings’.

   

2. You will access the Mailjet Settings section.

   

3. You need to connect your Mailjet account. Enter your API and Secret keys in the respective fields.

   

   Afterwards click on the ‘Save & Close’ to submit the changes.

   

4. If you want to test the settings of the Mailjet extension, tick the checkbox under ‘Send test mail now’ and enter a recipient email address.

   

The test email will be sent once you click on ‘Save & Close’. The sender address will be the ‘From Email’ you have selected in the ‘Global Configuration’ section.

 

Mailjet Subscription Widget

You have successfully configured the Mailjet module. The next step is to add a contact signup form to your website, so that you can easily capture new contacts directly from your site and synchronize them with your Mailjet contact lists. You can do this using the Mailjet Subscription Widget.

How to Add the Mailjet Subscription Widget

1. To start, in the Joomla admin click on ‘Extensions’ → ‘Modules’.

   

2. To add a new module, click on ‘New’.

   

3. You will see a list of possible modules you can add to your site. Look through the list to find the ‘Mailjet’ subscription widget and select it.

   

How to Configure the Mailjet Subscription Widget

You will now need to configure the widget. On the right-hand side you will see the general module configuration settings, and on the left-hand side the settings specific to the Mailjet widget module will be displayed.

First of all, you need to select a Title. This will be an internal name for the widget to be shown in the ‘Modules’ section.

The options specific for the Mailjet widget module are:

• select list - Choose the Mailjet Contact List to use. New subscribers that use the widget will be automatically added to that list. You can create additional lists in the ‘Contacts‘ section of the Mailjet module
• Button text - The text that will be displayed on the Subscribe button
• Email label - The label for the email input field
• Widget title - The title of the widget
• Success message - The message the user will receive when the subscription has been completed successfully
• Duplicate message - The message the user will receive if the email they entered is already present in the contact list
• Error message - The message the user will receive if the subscription could not be completed

Once you have finished configuring the widget, click on ‘Save’. When the changes are successfully saved, you will receive a confirmation message.

 

Mailjet Contacts

When someone subscribes to your site’s newsletters and/or marketing campaigns, their contact information is stored in a contact list. You can create and manage your contact lists from within the Joomla admin (‘Components’ → ‘Mailjet’ → ‘Contacts’) or from your Mailjet Account.

How to Manage Your Mailjet Contact Lists

To send out your marketing campaigns with Mailjet, you need to use contact lists that contain the contact details of all the subscribers you want to reach. You can use these contact details to further connect with your customers with email personalization, tailoring each email sent within a campaign to make your users feel unique and important.

Here you will see a list of all the contact lists you currently have on your Mailjet account. If any contacts were automatically migrated, you will also see a newly created contact list. If you have no contact lists, the area will be empty.

In this section you will be able to create, edit, duplicate, archive and delete your contact lists. You can also create new contact properties, or add emails to your Campaign Exclusion List.

For detailed information please visit our dedicated guide on Managing your contact lists.

Contact Properties

To store details about your subscribers (name, age, city, …) in your Mailjet contact list, you need to define/create the different contact properties you wish to associate with your Mailjet contacts. Once defined, you can then import your contact list details and map them to the relevant contact properties on the Mailjet side.

The inclusion of additional details regarding your subscribers will help you with personalizing emails in Mailjet, or with segmentation of the contact list for marketing campaigns, for example.

For more information on how to manage the properties, please visit the Contact Properties section of our guide on Managing Contact Lists.

 

Mailjet Campaigns

From within Joomla, you can design beautiful marketing newsletters using Mailjet’s drag-and-drop HTML email builder, or pick from a gallery of templates. With one easy click, you can also turn your newsletter design into a template for future use. In addition, you have the option to import already created templates by pasting the HTML code in our HTML editor.

To access the Mailjet Campaigns section, from the Joomla admin go to ‘Components’ → ‘Mailjet’ → ‘Campaigns’

For detailed information on how to create and send your campaigns, please visit our dedicated guide.

 

Mailjet Statistics

To view the powerful real-time analytics of your campaigns and emails, in the Joomla admin go to ‘Components’ → ‘Mailjet’ → ‘Statistics’.

Select the desired time range for the stats page.

By clicking on ‘Show me the reports’ you will be able to see information on each of the recipients of the campaign:

In addition to the Email List view (default), you can view the Open Analytics and the Click Analytics in a list view or via a map view.

By default, all emails statuses are displayed. You can filter the results to display only one email status via the ‘Status’ drop down menu.

To export the email lists section to a text file, click on the ‘Download all as CSV’ button.

To update a contact list based on the results, click on ‘Export to a list’. For example, if you wish to remove all the ‘bounced’ email addresses from a particular contact list, filter the results to show only ‘Bounce’, click on ‘Export to a list’ and follow the instructions.

 

Troubleshooting

In case you have questions or experience any issues with the Joomla functionalities, we encourage you to visit the Joomla Forums or their Documentation Portal.

Of course, feel free to contact our Customer Support team, in case you come across any technical difficulties with the Mailjet product - our team of specialists will be more than happy to assist you! Please visit the Mailjet ‘Contact Us’ page for more information.

 

Conclusion

We hope you find this guide helpful. Feel free to let us know what you think of our Joomla module, and especially what functionality we should do next by emailing plugins@mailjet.com.

Happy Emailing,

Mailjet Integrations Team