This repository was archived by the owner on Jan 25, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 9
Expand file tree
/
Copy pathreadme.txt
More file actions
240 lines (161 loc) · 9.74 KB
/
readme.txt
File metadata and controls
240 lines (161 loc) · 9.74 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
=== ActiveCampaign - Forms, Site Tracking, Live Chat ===
Contributors: activecampaign
Tags: activecampaign, email-marketing, newsletter, marketing-automation, subscribe, forms, emails, automation
Requires at least: 2
Tested up to: 5.1.1
Stable tag: trunk
Add ActiveCampaign contact forms and live chat to any post, page, or sidebar. Also enable ActiveCampaign site tracking for your WordPress blog.
== 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](https://www.activecampaign.com/customer-messaging/conversations).
Don’t have an ActiveCampaign account? [Sign up for a free trial](http://www.activecampaign.com/free/) to get started.
== Installation ==
This section describes how to install the plugin and get it working. Please see [our additional help documentation](http://www.activecampaign.com/help/integrating-subscription-forms-with-wordpress/) 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](http://www.activecampaign.com/) 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](https://www.activecampaign.com/customer-messaging/conversations).
= 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).
* **After upgrading go to WordPress ActiveCampaign settings and click "Update Settings" so it reloads the form code!**
= 6.2 =
* Fix for compatibility issue with Live Composer plugin.
= 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.