Learn how to install and set up the WooCommerce connector.
Overview
The WooCommerce connector lets you synchronise all of your WooCommerce customers to Dotdigital. You can choose which of your WooCommerce data fields get mapped to your Dotdigital contact data fields, allowing you to synchronise your customers' order histories and use it for better campaign targeting. You can also enrol new customers and new subscribers into your programs.
Before you can get going with any of the above, you must install the connector.
Before you start
Things you need to know:
- Check out The WooCommerce integration checklist to help track your progress.
- You need WordPress version 4.0 or later installed.
- You need the WooCommerce plugin version 1.6 or later installed.
Installing the WooCommerce connector
Existing Connection?
If you have an existing store that is connected to another environment such as a staging environment and now need to connect it to production, you need to disconnect it and connect the live store. This requires following all the steps below again, including downloading and installing the new bridge file.
The WooCommerce connector is WordPress-based and on-premise. A WordPress plugin is needed to perform the install, and then a bridge file needs to be downloaded from Dotdigital and added to your store's root directory to complete the connection.
Install the WooCommerce plugin
To install the WooCommerce plugin:
- Go to the Dotdigital GitHub page and download the plugin.
- Unzip the downloaded plugin file into your WordPress plugin folder.
The default location for this is
wordpress-root\wp-content\plugins. - Log in to your WordPress admin console.
- In the left-side menu, go to Plugins > Installed Plugins.
- Find the Dotdigital plugin.
- Select Activate Plugin.
- In the left-side menu, select Dotdigital to open the Dotdigital login page.
- Log in to Dotdigital.
- You'll see the 'Almost there!' message, outlining the three final steps to complete:
- Download the bridge zip file.
- Unzip the contents of the bridge file into your WordPress root folder.
- Select Test connection to check the connection is established between Dotdigital and your WooCommerce account.
Installing the bridge file
To install the bridge file:
- In Dotdigital, to download the connector bridge zip file, go to Ecommerce > Store.
The page and steps aren’t available until you install our plugin and add it to your store.
- In your Wordpress root folder, unzip the contents of the file.
The default root folder is
\var\www\html\wordpress - In Dotdigital, select Test connection to check and activate your WooCommerce connection.
Change to support subscribers
As WooCommerce doesn't natively support 'subscribers', Dotdigital makes an adjustment by adding a new 'subscribe' customer field to your customers, which is a Boolean (yes/no) data type.
In turn, a 'Subscribe to our newsletter' checkbox is added to your store's registration and checkout pages, allowing your customers to opt in.
Test connection
To make sure your connector bridge file is installed correctly, enter http://[YOUR STORE URL]/bridge2cart/bridge.php in your browser address line. If the bridge file is working correctly, the following message appears:
BRIDGE INSTALLED. Version: xx
If you don’t see the above message try some of our troubleshooting options below.
Bridge troubleshooting
Set bridge file permissions
To set the permissions of your bridge files when connected to your server.
Go to your bridge.php file and edit the numeric value to 644 or 666, depending on your server configuration.
Set bridge folder permissions
To set the permissions of your bridge folder when connected to your server.
Go to your bridge2cart folder and edit the numeric value to 755 or 777, depending on your server configuration.
Turn off website redirects
Turn off your website redirects so the connection bridge file functions properly.
Edit IP address allow list
Add the following IP addresses to your allow list:
- R1 / EU - 35.158.29.16
- R2 / US - 18.220.204.55
- R3 / AU - 13.55.107.246
Your web developers can help you to make this change.