-
Notifications
You must be signed in to change notification settings - Fork 5
/
readme.txt
288 lines (188 loc) · 10.1 KB
/
readme.txt
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
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
=== Dotdigital for WordPress ===
Contributors: dotMailer, bsstaveley, amucklow, fstrezos, pvpcookie
Tags: email marketing, newsletter signup
Requires at least: 5.3
Tested up to: 6.6.1
Requires PHP: 7.4
Stable tag: 7.2.4
License: MIT
License URI: https://opensource.org/licenses/MIT
Add the Dotdigital for WordPress plugin to your site and allow your visitors to sign up to your newsletter and email marketing campaigns.
== Description ==
Add the Dotdigital for WordPress plugin to your site and allow your visitors to sign up to your Dotdigital-powered newsletter and email marketing campaigns. The email addresses of new subscribers can be added to multiple Dotdigital lists.
If you're not a Dotdigital user already you can find out more about us at <a href="https://www.dotdigital.com">Dotdigital.com</a>.
== Installation ==
Please refer to our documentation for <a href="https://support.dotdigital.com/en/articles/8199395">detailed information on installation and usage</a>.
== Frequently Asked Questions ==
= Q. My site is hosted by WordPress.com. Will the plugin work for me? =
A. Yes, the plugin will work, but you will need the WordPress.com Business Plan to install plugins.
= Q. Can I select more than one list to sign contacts up to? =
A. You can opt to send contacts to multiple lists, some of which can be hidden from the user.
= Q. Can contacts who have previously unsubscribed from my mailing lists re-subscribe through the plugin? =
A. Yes they can.
= Q. My contacts are not appearing in my list. Why is this? =
A. Check you have followed the installation steps correctly and that your API email and API password appear exactly as they do in your Dotdigital account. Remember that the API email is automatically generated and should not be changed.
= Q. Can I send the user to a custom Thank You page after subscription? =
A. You can find the redirection options under the Redirections tab in the plugin dashboard. Here you can set up 3 options:
* No redirection (default): the user will stay on the same page where a short message will be displayed about the result of the subscription
* Local page: you can select a page from your website that will be your Thank you page
* Custom URL: with this option you can redirect your user wherever you want to. If you choose this option, please use a valid URL starting with "http://" or "https://" here.
You can also set redirection for any widget instance using the sidebar settings in the editor.
= Q. How can I insert a signup form into my posts and pages? =
A. The preferred approach is to use the WordPress editor, and simply drag either of our blocks into the content area. An alternative (useful if your posts and pages don't use the WordPress editor), you can also use the [dotdigital-signup] shortcode to show the form inside the post's content. Shortcode parameters:
showtitle - Hide the title of the widget (defaults to 0)
showdesc - Hide the description under the title (defaults to 0)
with_ajax - Submit form without reloading page (defaults to 0)
redirection - Redirect the user to a custom URL after successful submission
Example:
[dotdigital-signup showtitle=0 showdesc=0 with_ajax=1 redirection="http://www.example.com"]
The form will behave as follows:
- no title
- no description
- form will submit without a page reload
- user will be redirected to http://www.example.com on submit
== Screenshots ==
1. Enter your Dotdigital API credentials to get started.
2. Select list(s).
3. Capture additional contact data.
4. Add a simple newsletter signup form in the WordPress editor.
5. Add an embedded survey from Dotdigital.
6. Add a popover form from Dotdigital.
== Changelog ==
= 7.2.4 =
**Bug fixes**
- We fixed a bug with lists being sent to the V3 API in the incorrect type.
- We fixed submission failure with no data fields.
= 7.2.3 =
**Bug fixes**
- We fixed a bug with surveys, pages and forms not loading into the block select.
= 7.2.2 =
**Bug fixes**
- We fixed a regression in 7.2.1 that broke the save action for the plugin's admin tabs.
= 7.2.1 =
**Bug fixes**
- We've added restrictions around the loading of plugin menu tabs, to prevent clashes with other plugins.
= 7.2.0 =
**What's new**
- Merchants can now add a `with_ajax` argument to the `[dotdigital-signup]` shortcode.
**Bug fixes**
- We standardised submission payloads between AJAX and non-AJAX modes, resolving an ‘undefined index’ bug in the widget controller.
= 7.1.2 =
**Bug fixes**
- We fixed a problem with form submissions not redirecting from the REST endpoint.
= 7.1.1 =
**Improvements**
- We updated the label for the AJAX submission checkbox in our signup form block.
= 7.1.0 =
**What's new**
- Dotdigital Signup Form blocks can now be submitted via AJAX.
**Improvements**
- We updated a support link in our readme.txt.
= 7.0.0 =
**What's new**
- The plugin has been rewritten to fit a more modern, object-oriented boilerplate.
- We have provided a new Gutenberg block - 'Dotdigital Signup Form' - for the main plugin widget.
- A new block is also available to embed Surveys, Pages and Forms from Dotdigital.
- We've added a daily cron to gather data from the plugin configuration and widget usage.
**Improvements**
- The plugin's vendor namespaces are now prefixed before SVN submission, to prevent namespace clashes.
= 6.0.3 =
**Bug fixes**
- We repaired HTML input types for data fields displayed in the signup widget.
= 6.0.2 =
**Bug fixes**
- Address book and data field sorting has been repaired.
- Custom labels for address books and data fields now display correctly.
= 6.0.1 =
**Bug fixes**
- Incorrect API credentials could cause a fatal error after upgrade to v6.0.0; such errors are now handled appropriately.
= 6.0.0 =
**What's new**
- We've replaced the romanpitak API client library with our own PHP SDK for the Dotdigital API.
- This plugin now requires PHP 7.4 and is compatible with WordPress 5.3+.
**Improvements**
- We've started to bring the codebase in line with WordPress coding standards.
= 5.0.3 =
**Improvements**
- We've improved handling of account info when entering API credentials.
- We repaired some errors to do with validating required data fields.
**Bug fixes**
- Redirection now works as expected when using our shortcode in posts and pages.
= 5.0.2 =
**Improvements**
* We removed some dormant code concerned with collecting system data from the WordPress instance.
**Bug fixes**
* API credentials are no longer exposed in the stack trace in the event of a fatal error.
= 5.0.1 =
**Bug fixes**
* If no address books are selected, contacts will now be added to ‘All contacts’.
* We fixed a typo in the spelling of 'Unsubscribed'.
= 5.0.0 =
**What's new**
* The plugin has been renamed and rebranded.
* The `[dotdigital-signup]` shortcode has been added to replace `[dotmailer-signup]` (although that shortcode will continue to work).
**Improvements**
* We've made a number of presentational updates and improvements.
* Redirection on submit will now be blocked if the form has errors.
**Bug fixes**
* We fixed a bug to do with error detection in the `shutdown()` function.
* We've updated our check for contact status when a contact is retrieved from Dotdigital.
* We improved error handling for invalid API credentials.
4.0.5 (2017-11-28)
* Mod: PHP7 support
* Mod: Redirection url is always followed regardless of validation result
4.0.1 (2016-06-06)
* Fix: endpoint discovery error where region ID > 1
* Fix: small calendar display issue
4.0 (2016-03-04)
* Mod: the plugin is rewritten using the dotmailer REST (v2) API
* Add: endpoint discovery added - now your API calls use your regional API URL
* Fix: a few small layout fixes
3.4.2 (2015-07-01)
* Fix: position of the shortcode output wasn't correct in the previous versions
3.4.1 (2014-07-17)
* All strings from 'dotMailer' are changed to 'dotmailer' due to a branding change
3.4 (2014-07-03)
* Add: Redirection options in plugin admin, now you can redirect your users to a Thank You page after subscription
* Add: redirection attribute for the shortcode, which lets you use redirections locally from your form shortcodes
3.3 (2014-06-14)
* Add: Now you can add the dotMailer form with the [dotmailer-signup] shortcode to your posts and pages
* Fix: Wrong input type in forms (String) changed to (text)
* Fix: Some code cleanup
3.2.1 (2014-05-16)
* Fix: Now the user stays on the same page instead of being redirected to the home page after submission
3.2 (2014-05-02)
* Fix: Remove warning in the widget if no contact data was saved into the DB
* Fix: Version number confusion
* Mod: Now initial default messages are saved automatically to the database during plugin activation, so users need one step less to set it up properly.
* Mod: Now user settings are not deleted on plugin deactivation. Settings are only deleted if you uninstall the plugin.
== Upgrade Notice ==
= 4.0 =
* Mod: the plugin is rewritten using the dotmailer REST (v2) API
* Add: endpoint discovery added - now your API calls use your regional API URL
* Fix: a few small layout fixes
= 3.4 =
* Add: Redirection options in plugin admin, now you can redirect your users to a Thank You page after subscription
* Add: redirection attribute for the shortcode, which lets you use redirections locally from your form shortcodes
= 3.3 =
* Add: Now you can add the dotMailer form with the [dotmailer-signup] shortcode to your posts and pages
* Fix: Wrong input type in forms (String) changed to (text)
* Fix: Some code cleanup
= 3.2.1 =
* Fix: Now the user stays on the same page instead of being redirected to the home page after submission
= 3.2 =
* Fix: Remove warning in the widget if no contact data was saved into the DB
* Fix: Version number confusion
* Mod: Now initial default messages are save automatically to the database during plugin activation, so users need one step less to set it up properly.
* Mod: Now user settings are not deleted on plugin deactivation. Settings are only deleted if you uninstall the plugin.
= 3.1 =
* Fix for closing php tag on dm_widget
= 3.0 =
* Fix for reported javascript conflicts and styling issues
= 2.1 =
* Fix for Jquery Mini File, upgraded version to fix conflict
= 2.0 =
* Using the new Settings API.
* Extra features added.
= 1.1 =
* Fixed an error thrown