Skip to content
This repository has been archived by the owner on Jan 25, 2020. It is now read-only.

ActiveCampaign/app-wordpress

Repository files navigation

ActiveCampaign WordPress Plugin

Allows you to add ActiveCampaign contact forms or live chat to any post, page, or sidebar. Also allows you to embed ActiveCampaign site tracking code in your pages. To get started, please activate the plugin and add your API credentials in the plugin settings.

Description

The ActiveCampaign Wordpress plug-in allows you to:

  1. Embed ActiveCampaign forms directly into any post, page, or sidebar
  2. Use Site tracking to track visitors to your website
  3. Enable live chat for accounts using Conversations

After installation, go to Settings > ActiveCampaign to activate this plugin. You will need your ActiveCampaign API URL and key, and at least one integration form created in your ActiveCampaign account.

The live chat feature is part of Conversations, a multi-channel customer communication tool available as an add-on for all ActiveCampaign accounts. You can learn more here.

Don’t have an ActiveCampaign account? Sign up for a free trial to get started.

Installation

This section describes how to install the plugin and get it working. Please see our additional help documentation for more detailed information.

  1. Upload the entire "activecampaign" zip file to the Plugins section of WordPress, or "Add New" plugin and search for "activecampaign."
  2. Visit the Settings > ActiveCampaign section in WordPress.
  3. Fill in your ActiveCampaign connection details, then hit Update.
  4. Choose which subscription forms to cache locally, any optional sub-settings for each, then hit Update again.
  5. Use [activecampaign form=ID] shortcode to display a form anywhere on your site where shortcode syntax is supported.
  6. Embed multiple forms onto a single page!
  7. Enable site tracking to have page visits tracked to ActiveCampaign.

Frequently Asked Questions

How do I create ActiveCampaign subscription forms to use in WordPress?

You need to be using ActiveCampaign email marketing platform to use this widget. Create new subscription forms in the platform by going to the "Integration" section, then they will be available through this plugin.

How does this plugin differ from copying and pasting the subscription form onto my site manually?

This plugin makes it much easier to do without requiring you to know which theme (or core WordPress) files to modify. Also, copying and pasting HTML into WordPress can often cause odd display issues (depending on your WordPress theme).

What happens after someone submits the subscription form on my WordPress site?

The same thing that would happen if they submitted it from another site: it redirects back to the ActiveCampaign confirmation message, or a custom URL if you have that set up for the subscription form in ActiveCampaign (modify your forms under the "Integration" section).

If you enable the "Ajax" option of the plugin settings, you can have the form submitted without the page reloading (so the viewer never leaves the page).

Can my form require an opt-in email confirmation be sent?

Yes, you would just make sure that your form settings (in ActiveCampaign) have the Opt-in confirmation setting checked.

How does live chat work?

Live chat is a feature of Conversations, an add-on available to ActiveCampaign users that enables multi-channel communication with your customers through a unified inbox. To activate live chat for your Wordpress website you must first start a trial or purchase Conversations. Learn more here.

How will I know I have received a live chat message from a visitor?

All live chat messages will display in the Conversations inbox in your ActiveCampaign account. You can receive desktop and audio notifications when the messages are received, or use our Conversations mobile app (available for iOS and Android) to get push notifications on your phone and respond on the go.

I get a "Connection failed" message. What does this mean?

Please make sure that your login information is correct, and that you have at least one Integration form already created in the ActiveCampaign system.

Screenshots

  1. Settings page for ActiveCampaign plugin
  2. Configuring your form settings
  3. Using the [activecampaign] shortcode in a blog post
  4. Viewing the output of the [activecampaign] shortcode
  5. Adding a form to the sidebar
  6. Adding multiple forms
  7. Conversations chat widget

Changelog

7.1.2

  • Update tracking code copy to be more specific to Site Tracking and Conversations.
  • Fix old link to Forms page.
  • Make install code toggle focusable.

7.1.1

  • Include our own host header on requests.

7.1

  • Update plug-in to enable Live Chat.

7.0

  • Force upgrade prompt for users on 6.25.
    • The prior version (6.3) is technically smaller than 6.25 in semantic versioning so users on 6.25 won't ever see an upgrade prompt unless we got to 6.25.1 or 6.26.

6.3

  • Added site tracking options for GDPR.

6.2.12

  • Fix for when the "form_id" key is undefined.

6.2.11

  • Fix for when the "site_tracking" key is undefined.

6.2.10

  • Limit amount of ActiveCampaign account data shown in JavaScript (for site tracking).

6.2.9

  • Fix for "Keep original form CSS" checkbox not being respected.

6.2.8

  • Fix for Undefined index: css error.

6.2.7

  • Fix for 6.2.6 change missing another check.

6.2.6

  • Fix for certain error messages not being displayed properly.

6.25

  • Fix for SSL issue (when the page is loaded via HTTPS and the AC account uses a CNAME, forms would not show up).

6.2

  • Fix for issue with new forms not displaying properly.

6.1

  • Fix for issue with new forms not displaying properly.

6.0

  • Added support for new form builder.

5.93

  • Fix for issue with captcha verification when using the Ajax ("Submit form without refreshing page") form submission option.

5.92

  • Support for captcha validation when using the 'Submit form without refreshing page' (Ajax) option.
  • Added success or error CSS classes to the Ajax response div.

5.91

  • Updates to avoid conflicts with other plugins using the ActiveCampaign PHP API wrapper.

5.9

  • Use current user's email for site tracking.

5.8

  • Security fix.

5.7

  • Removed ability to add custom form "action" URL.

5.6

  • Patched major security bug.

5.5

  • Added site tracking (optional setting).

5.2

  • Default form behavior is now "sync." This coincided with WordPress version 3.9 release.

5.1

  • Added button to TinyMCE toolbar to more easily choose and embed the form shortcode into the post body.

5.0

  • Added support for multiple forms. Removed widget entirely.

4.5

  • Added ActiveCampaign to the Settings menu so you can use the shortcode independent of the widget.

4.0

  • Added many additional settings to control how your form is displayed and submitted.

3.5

  • You can now use a shortcode to display your subscription form.

3.0

  • Re-wrote widget backend to use most recent WordPress Widget structure.
  • Streamlined code and API usage.
  • Ability to reset or refresh your forms.
  • Better form width detection.

2.1

  • Changed internal API requests to use only API URL and Key instead of Username and Password.
  • Provided option to remove style blocks from embedded form code, and converting input type="button" into input type="submit".

2.0

  • Re-configured to work with ActiveCampaign version 5.4.
  • Improved some areas.

1.1

  • Verified this works with latest versions of WordPress and ActiveCampaign.
  • Updated installation instructions.

1.0

  • Initial release.

Upgrade Notice

6.3

  • After upgrading go to ActiveCampaign settings and make sure your Site Tracking setting and options are set appropriately.

6.25

  • After upgrading go to ActiveCampaign settings and click "Update Settings" so it reloads the form code.

6.1

  • After upgrading go to ActiveCampaign settings and click "Update" again so it reloads the form code.

6.0

  • After upgrading go to ActiveCampaign settings and click "Update" again so it reloads the form code.

5.9

  • Site tracking users: the current logged-in user will now be associated with each page visit.

5.8

  • UPGRADE IMMEDIATELY - security fix. After upgrading go to ActiveCampaign settings and click "Update" again so it reloads the form code.

5.7

  • Custom form "action" URL's will no longer work.

5.6

  • UPGRADE IMMEDIATELY - security bug patched (involving the API key being exposed). After upgrading go to ActiveCampaign settings and click "Update" again so it reloads the form code.

5.5

  • If site tracking is enabled it will embed some JavaScript code on each of your front-end pages.

5.2

  • Default behavior of the form is now "sync" (add or update). If you had "Add Subscriber" chosen it will now perform "add or update." If you had "Sync Subscriber" chosen the behavior will remain the same.

5.0

  • The widget is removed entirely (in favor of the shortcode) so if you have a form in a sidebar, you'll now need to add a basic text widget with the shortcode in it. You choose your forms under the ActiveCampaign settings section.

4.0

  • If you use the Ajax option, you will need jQuery enabled for your WordPress site.

2.1

  • This version requires the use of API URL and Key instead of Username and Password.

2.0

  • Version 2.0 will NOT work with ActiveCampaign versions < 5.4.

1.1

  • Installation instructions updated if you are having trouble installing it.