WooCommerce Constant Contact

Overview ↑ Back to top

The WooCommerce Constant Contact integration lets you signup customers to your Constant Contact email lists during checkout. Use the included widget to add a signup form to other areas of your site and start building your email list today.

Installation ↑ Back to top

  1. Download the extension from your WooCommerce dashboard
  2. Goto Plugins > Add New > Upload and select the ZIP file you just downloaded
  3. Click Install Now, and then Activate
  4. Click the Configure link and read the next section to learn how to setup and configure the plugin.
This extension requires a Constant Contact account, WooCommerce 2.3 or newer, and cURL installed on your server (don’t worry, most servers have this by default)

Setup and Configuration ↑ Back to top

This plugin uses the Constant Contact v1 API, so v2 API keys should not be used until you see a notice about upgrading in the changelog.

These instructions on obtaining API keys are for the v1 API.

To get started, go here and login with your Constant Contact username and password:

WooCommerce Constant Contact Setup 1

Next, click the link to request a new API key:

WooCommerce Constant Contact Setup 2

Now, enter your website address for the display name, your email for the technical contact, and enter “WordPress/WooCommerce Integration” for the Application Description. You may leave the rest of the fields blank.

WooCommerce Constant Contact Setup 3

Submit the form, and check the box on the next page to agree to the terms, then hit “Request an API Key”:

WooCommerce Constant Contact Setup 4

Now, copy the Key listed on the next page:
WooCommerce Constant Contact Setup 5

Then paste it into the API Key text box under WooCommerce > Settings > Constant Contact:

WooCommerce Constant Contact Integration Settings
Constant Contact Admin Settings

Now enter your Constant Contact username and password and hit “Save Settings”. You should see the email lists from your Constant Contact account appear in the “Email List” box. Select which email list you want customers’ email addresses to be added to when they sign up at checkout. Click “Save Settings” and you’re done! Read on to learn more about the settings and other extension features.

Extension Settings ↑ Back to top

  • Subscribe Checkbox Label – This is the text that appears to the signup checkbox on checkout, which by default looks like:WooCommerce Constant Contact Checkout Signup
  • Subscribe Checkbox Default – Choose whether the signup checkbox is checked or unchecked by default.
  • Email List – Choose the Constant Contact email list that email addresses will be added to when a customer has opted in during checkout.
  • ConstantContact.com Username – This is the username that you use to log into constantcontact.com.
  • ConstantContact.com Password – This is the password that you use to log into constantcontact.com.
  • API Key – This is the API key obtained by following the process detailed above.
  • Debug Mode – Turn this on if you are having issues. Any errors will be logged to the WooCommerce error log, which you can submit along with a support ticket.

Functionality ↑ Back to top

Checkout Signup ↑ Back to top

By default, a checkbox will be added to the checkout page that will add the email address used by the customer (their billing email address) to the Constant Contact list specified in the admin settings:

WooCommerce Constant Contact Signup

Order Received Signup ↑ Back to top

A message is also added to the “Order Received” page with a button that will add the customer to the email list. This is displayed so that customers who might have missed the signup checkbox on the checkout page have an opportunity to sign up, and so that customers who have checked out using a payment gateway like PayPal Express (which completely skips the checkout page) also have an opportunity to signup. You can control the content of this message by using the filters detailed below.

Displayed on the Order Received page
Displayed on the Order Received page
Displayed when the customer clicks the "Subscribe Now" button
Displayed when the customer clicks the “Subscribe Now” button

Widget Signup Form ↑ Back to top

You can also add a widget anywhere on your site (go to Appearance > Widgets and look for “WooCommerce Constant Contact”) that will display a signup form for the email list you select:

WooCommerce Constant Contact add widget

Remember that you must have entered your username/password/API key on the settings page first before using this widget. You can change the title and the list that email signups are added to. Once you’ve set this up and hit “Save”, your widget will appear like this:

WooCommerce Constant Contact Widget

Troubleshooting ↑ Back to top

Are you getting a 404 not found error when saving settings? Ask your host to disable mod_security for your website. In most cases, mod_security is not configured appropriately and restricts some vital processes; in this case, it conflicts with the way list IDs are saved for Constant Contact.

Having other trouble? Follow these steps to make sure everything is setup correctly before posting a support request:

  1. Check that your Constant Contact Username, Password, and API Key are correct.
  2. Double-check that your Constant Contact Username, Password, and API Key are correct. 😉
  3. Enable debug mode and check the WooCommerce error logs (under /wp-content/woocommerce/logs/constant-contact.txt) for any obvious error messages.
  4. Submit a support ticket, with the constant-contact.txt log as an attachment.

For Developers ↑ Back to top

Actions/Filters ↑ Back to top

apply_filters( 'wc_constant_contact_order_received_button_text', __( 'Subscribe Now', WC_Constant_Contact::TEXT_DOMAIN ) )

Use this filter to change the button text for the signup message on the order received page.

apply_filters( 'wc_constant_contact_order_received_subscribe_message', $message, $order_id )

Use this filter to completely change the HTML of the signup message on the order received page. Do not change the button anchor ID or the AJAX signup will not work.

apply_filters( 'wc_constant_contact_order_received_subscribe_success_message', __( 'Thanks for subscribing!', WC_Constant_Contact::TEXT_DOMAIN ) )

Use this filter to change the message that is displayed when a customer signs up on the order received page.

Questions & Support ↑ Back to top

Have a question before you buy? Please fill out this pre-sales form.

Already purchased and need some assistance? Get in touch with support via the help desk.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top