Planning on upgrading?Read more if you're thinking of upgrading your existing Magento connector.
The Engagement Cloud for Magento connector 1.0/2.0 can be installed in various ways, and these are outlined further below. Firstly though this article begins with guidelines for a pre-installation health check to ensure all goes as well as possible before, during and after installation.
Please note that this extension is provided as is. Our recommendation is to always backup your installation prior to use.
Versions and compatibility
The Engagement Cloud for Magento connector is compatible with both Community and Enterprise platforms of Magento.
For Community, we’re compatible with:
For Enterprise, we’re compatible with:
While every site is different, the connector could potentially come into conflict with other extensions.
For instance, other extensions using namespace could conflict with front name 'connector' previously used to access dynamic content, which is pulled from the site on a send.
Abandon cart extensions and other SMTP tools could also possibly come into conflict with the connector, and this makes it important to state these during the installation process.
Please note: Core rewrite conflicts with Newsletter\Model\Subscriber.php, Customer\Model\Customer.php, Core\Model\Email\Template.php
The Engagement Cloud for Magento connector has several cron tasks attached with the install to ensure the connector functions correctly.
Below are the current tasks and their timings:
• ddg_automation_abandonedcarts - at five minute intervals
• ddg_automation_campaign - at five minute intervals
• ddg_automation_catalog_sync - at 15 minute intervals
• ddg_automation_cleaner – on the 1st of every month
• ddg_automation_customer_subscriber_guest_sync - at 15 minute intervals
• ddg_automation_importer - at five minute intervals
• ddg_automation_order_and_quote_sync - at 15 minute intervals
• ddg_automation_reviews_and_wishlist - at 15 minute intervals
• ddg_automation_status - at 15 minute intervals
The cron heartbeat should be running every five minutes to action the required tasks and the synchronisation of data into the Engagement Cloud account. The connector is unable to function correctly without it.
File permissions on var/export
File permissions on your site are an important part of the connector being able to write imports to be sent over to Engagement Cloud.
The connector will require full access (0777) to the var/export/email and var/export/email/archive directory or full access to the CRON user running on the server.
UAT and sandbox environments
Engagement Cloud always recommends testing any new deploys/extensions within sandbox/UAT environments, enabling you to check the compatibility with your site and other extensions you may have installed.
For UAT and sandbox environments, you should check the types of your contact data fields in Engagement Cloud plus any possible firewall restrictions for API calls, i.e. when connecting an API user between Engagement Cloud and Magento.
You can do this by creating a separate trial account of Engagement Cloud.
If you happen to want to, or need to, completely reset all of your Engagement Cloud tables after install, you can do so. It will have the same effect as performing a fresh install.
Resetting tables is an extremely critical operation and should only be done when your site is in maintenance mode.
Click Run Now and all tables will be removed, recreated and all data in them will be refilled anew.
This is found by going to System > Configuration > DOTMAILER > Developer and clicking on 'Sync Settings'.
Before you can enjoy all of these benefits, however, you must first successfully install the connector. To do this, follow the steps below:
1. Login to your Magento account and locate the Magento Connect store within their site; this is Magento's extensions marketplace. Search for 'dotmailer' in the extensions search box in the top right corner of this page. This will find the Engagement Cloud connector for you (alternatively, click on the links provided in 'General - Getting started'). Clicking on the title will take you through to the connector's details page.
Click on Install Now, accept the terms and conditions, and then click on Get Extension Key. Copy the extension key to your clipboard.
2. Return to your Magento admin panel and go to System (along the top navigation bar) > Magento Connect > Magento Connect Manager.
You will be asked to login again with your Magento Administration Credentials.
You'll then go through to the 'Extensions' page. Look under 'Settings' and untick the appropriate box to put your store into maintenance mode, then paste the extension key into the appropriate field under 'Install New Extensions', followed by clicking Install.
3. At this point, information will appear allowing you to check whether you're installing the latest version of the connector. If this is correct, click Proceed and the installation will begin.
4. The panel at the foot of the page will indicate when the process is complete by confirming that the cache has been cleaned successfully. After this has been confirmed, click Refresh to refresh the cache and then return to the Magento admin panel. You will be required to logout of the admin panel and then log back in to complete the installation.
5. Confirm the installation has completed correctly by visiting System > Configuration and then locating your new DOTMAILER configuration section in the left-hand menu.
Select the API Credentials; if this loads correctly, the install has worked.
1. Go to our official Magento 1.0 public repository - https://github.com/dotmailer/dotmailer-magento-extension.
2. Download it as a ZIP.
3. Unzip the file.
4. Drop/move all of the source folder content inside the unzipped file into the corresponding destination folders - https://raw.githubusercontent.com/dotmailer/dotmailer-magento-extension/testing/modman.
5. Clear cache or disable the cache before installing the extension.
6. Log out for the ACL to update.
7. Log in again.
1. Set up the correct path for Composer or keep Composer within Magento root.
2. In Magento root, run command 'composer require dotmailer/dotmailer-magento2-extension'.
3. After the above is successful, run the command 'php bin/magento module:enable Dotdigitalgroup_Email' in Magento root. This will let Magento know about the module.
4. Run the command 'php bin/magento setup:upgrade' in Magento root. This will ensure any installer scripts we may have are executed properly and store the current data version.
5. Run the command 'php bin/magento setup:di:compile' if you have a single website and store, or 'php bin/magento setup:di:compile-multi-tenant' if you have multiple ones.
6. Clear cache from Magento admin.
1. Go to our official Magento 2 public repository - https://github.com/dotmailer/dotmailer-magento2-extension/releases.
2. Download it as a ZIP.
3. Unzip the file.
4. Make sure to create the directory structure in your Magento - 'Magento_Root/app/code/Dotdigitalgroup/Email'.
5. Drop/move all of the content inside the unzipped folder to directory 'Magento_Root/app/code/Dotdigitalgroup/Email' on FTP.
6. Run the command 'php bin/magento module:enable Dotdigitalgroup_Email' in Magento root. This will let Magento know about the module.
7. Run the command 'php bin/magento setup:upgrade' in Magento root. This will ensure any installer scripts we may have are executed properly and store the current data version.
8. Run the command 'php bin/magento setup:di:compile' if you have a single website and store, or 'php bin/magento setup:di:compile-multi-tenant' if you have multiple ones.
9. Clear cache from Magento admin.
Please comment underneath with any questions you may have.