-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
528 lines (289 loc) · 12.9 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
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
=== Ninja Forms - Conditionals Extension ===
Contributors: kstover, jameslaws, kbjohnson, klhall1987, Much2tall, deckerweb
Donate link: http://ninjaforms.com
Tags: form, forms
Requires at least: 5.2
Tested up to: 5.4
Stable tag: 3.1
License: GPLv2 or later
== Description ==
The Ninja Forms Conditionals Extension allows you to create "smart" forms that can change dynamically based upon user input. Options can be added to dropdown lists based upon other input, or fields can be hidden or shown.
== Screenshots ==
To see up to date screenshots, visit [NinjaForms.com](http://ninjaforms.com).
== Installation ==
This section describes how to install the plugin and get it working.
1. Upload the `ninja-forms` directory to your `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Visit the 'Forms' menu item in your admin sidebar
4. When you create a form, you can now add conditionals on the field edit page.
== Use ==
For help and video tutorials, please visit our website: [Ninja Forms Documentation](http://ninjaforms.com/documentation/intro/)
== Changelog ==
= 3.1 (21 April 2021) =
*Changes:*
* Conditions can now compare date fields. This allows users to create conditions that trigger when someone selects or enters a specific date or range.
= 3.0.28 (4 August 2020) =
*Bugs:*
* Resolved an issue that was preventing file uploads from being saved properly upon submission.
* Conditions should no longer lose reference to fields that have been renamed in the form builder.
= 3.0.27 (23 July 2020) =
*Bugs:*
* Resolved an issue that was causing conditions on actions to be ignored.
= 3.0.26.2 (21 July 2020) =
*Bugs:*
* Resolved an issue with the plugin auto-updater.
= 3.0.26.1 (20 July 2020) =
*Security:*
* Patched a data spoofing vulnerability that allowed required fields to be bypassed.
= 3.0.26 (25 September 2019) =
*Bugs:*
* Resolved an issue that sometimes prevented actions from firing, even when they had no attached conditions.
* Forms with a Stripe or PayPal action should now properly complete once returning from the payment screen.
= 3.0.25 (16 September 2019) =
*Bugs:*
* Hidden fields should now properly evaluate against empty.
* Recaptcha fields that are hidden will now properly render once shown.
*Changes:*
* Fields can now be conditionally set as required.
= 3.0.24 (23 January 2019) =
*Bugs:*
* Conditions based on calculations should now be properly triggered on form load.
* Resolved an issue that was sometimes causing actions to always fire, regardless of conditions.
*Changes:*
* Several incompatible field types have been removed from the list of fields that conditions can be based on.
* Inverse statements will no longer be created by default on new do statements.
= 3.0.23 (11 January 2019) =
*Bugs:*
* Action processing will now ignore incomplete conditional statements, which previously prevented the action from firing.
= 3.0.22 (14 June 2018) =
*Changes:*
* Fields now display admin labels (if they exist) instead of labels in condition blocks.
= 3.0.21 (3 May 2018) =
*Bugs:*
* Equals conditions based on calculations should now work properly.
= 3.0.20 (19 April 2018) =
*Bugs:*
* Duplicating a field should no longer cause conditional logic to lose track of it as a conditional trigger.
= 3.0.19 (26 March 2018) =
*Bugs:*
* Conditions based on the selection of single checkbox fields should now function properly.
= 3.0.18 (24 February 2018) =
*Bugs:*
* Checkbox values can now be updated via conditional logic again.
= 3.0.17 (22 August 2017) =
*Bugs:*
* Actions that use the greaterthan and lessthan comparators should work properly.
* Incorrectly setup conditions should no longer cause form display to crash.
= 3.0.16 (02 August 2017) =
*Bugs:*
* Action conditions should now properly support calculations.
* Fixed a bug that could cause calculations to fail when using Conditional Logic.
= 3.0.15 (27 June 2017) =
*Changes:*
* When setting up conditions, fields should now appear in alphabetical order within the field list.
*Bugs:*
* Conditional Logic should now work properly with the Save Progress add-on.
= 3.0.14 (31 May 2017) =
*Bugs:*
* Tabbing through a checkbox list that has conditions will no longer trigger those conditions incorrectly.
= 3.0.13 (02 May 2017) =
*Bugs:*
* Fixed a fatal error with PHP version 7.1 and higher.
= 3.0.12 (11 April 2017) =
*Changes:*
* Actions like Stripe can now be conditionally ran.
*Bugs:*
* Fixed a bug that caused some conditions to evaluate improperly.
= 3.0.11 (19 January 2017) =
*Changes:*
* Textbox fields can now be compared to an empty string.
*Bugs:*
* Help text should render properly for conditionally shown/hidden fields.
= 3.0.10 (09 December 2016) =
*Bugs:*
* Fixed a bug that could cause the condition drawer to fail to open if a field was deleted.
* Conditional Logic shouldn't prevent or enable actions that are otherwise disabled.
= 3.0.9 (15 November 2016) =
*Bugs:*
* Fixed a bug with list field options incorrectly triggering conditions based on partial matches.
* Fixed a bug with missing field values causing the form to not submit properly.
* Fixed a bug with false-positives when tabbing through a checkbox field.
*Changes:*
* Use the form cache for getting field data.
* Corrected processing for different data structures.
* Added a check for manually disabled actions, so as to not re-enable with conditions.
= 3.0.8 (25 October 2016) =
*Bugs:*
* The "any" operator in actions should work properly in all cases.
* Fixed a bug that caused fatal errors when conditions weren't configured properly.
= 3.0.7 (13 October 2016) =
*Bugs:*
* Creating conditions can now properly be based upon calculations.
* Fixed a bug with radio lists and the select option trigger.
*Changes:*
* When building conditions, fields should now show up with their admin label if one is set.
= 3.0.6 (03 October 2016) =
*Bugs:*
* Required fields should no longer attempt to valide upon show.
* Country fields can now be used in conditions.
* Fixed a couple of conversion issues with older form imports.
* Conditionally shown/hidden fields should all show properly in submission data.
*Changes:*
* Conditions can now be created using > and < with textboxes and textareas.
= 3.0.5 (28 September 2016) =
*Bugs:*
* File Uploads should now show in Conditional Logic conditions.
= 3.0.4 (22 September 2016) =
*Bugs:*
* Fixed a bug that could cause the builder to crash when fields were removed if there was a condition based upon that field.
= 3.0.3 (11 September 2016) =
* Bugs:*
* Fixed a bug that caused the condition edit drawer to fail to open.
= 3.0.2 (09 September 2016) =
* Fixed a bug with conversion.
= 3.0.1 (06 September 2016) =
* Updated with Ninja Forms v3.x compatibility
= 3.0 (06 September 2016) =
* Updated with Ninja Forms v3.x compatibility
* Deprecated Ninja Forms v2.9.x compatible code
= 1.4.0 (13 April 2016) =
*Changes:*
* Update for compatibility with WordPress 4.5 ( specifically the underscore.js update ).
= 1.3.9 (26 May 2015) =
*Bugs:*
* Changed values should now reset to defaults when using the "clear form" setting.
= 1.3.8 (12 May 2015) =
*Bugs:*
* Array elements should now work properly with the "Contains" action conditionals.
* Fixed a PHP Notice.
* Decimals should now be compared properly.
* Fixed a bug that could cause a PHP error if asp style tags are enabled in PHP.
= 1.3.7 (18 March 2015) =
*Bugs:*
* Fixed a bug that could cause conditional field data to submit improperly.
= 1.3.6 (17 March 2015) =
*Bugs:*
* Fixed a bug that could cause JavaScript to load older versions of files.
= 1.3.5 (4 March 2015) =
*Bugs:*
* Fixed a bug that could cause conditionally hidden calculations to fail.
* List options should work properly in version 2.9 of Ninja Forms.
= 1.3.4 (3 March 2015) =
*Bugs:*
* Fixed a bug that could prevent new conditions from being added.
= 1.3.3 (27 February 2015) =
*Changes:*
* Preparing for the release of Ninja Forms version 2.9.
= 1.3.1 (17 November 2014) =
*Bugs:*
* Fixing bad domain/translation issues.
* Fixed a bug with checkbox lists and notification conditions.
* Duplicating a page with conditions using multi-part forms should now properly duplicate those conditions.
* Fixed several issues related to i18n.
= 1.3 (28 October 2014) =
*Features:*
* Conditional Logic now supports conditional notifications.
* Only show, display, or send a notification when a user submits specific form data.
*Changes:*
* Custom conditional triggers can be added for notifications.
*Bugs:*
* Fixed a bug that caused conditionals based upon other conditional fields to work improperly.
* Conditionally hidden totals should now be properly removed from the all fields table.
= 1.2.7 (24 July 2014) =
*Changes:*
* Compatibility with Ninja Forms 2.7.
= 1.2.6 =
*Bugs:*
* Fixed a bug that prevented some users from getting automatic updates.
= 1.2.5 =
*Bugs:*
* Fixed a bug that could cause conditions not to work in some AJAX setups.
= 1.2.4 =
*Changes:*
* Conditionals should now not be applied when editing a form in the wp-admin.
*Bugs:*
* Fixed a bug with the change value setting.
= 1.2.3 =
*Bugs:*
* Fixed a bug that prevented the 'add_value' and 'change_value' actions from working properly in some instances.
= 1.2.2 =
*Bugs:*
* Fixed a bug with required fields that were conditionally hidden.
* Removed console logs that were causing problems in IE9.
* Fixed a bug that caused the Add Value setting not to work properly.
= 1.2.1 =
*Bugs:*
* Fixed several bugs that related to pre-populating conditional fields with multi-part forms.
= 1.2 =
*Changes:*
* Added support for the new Ninja Forms loading system. This should significantly improve loading speed for forms that use conditionals.
= 1.1.1 =
*Bugs:*
* Fixed a bug that could prevent conditionals from working properly with required fields.
* Fixed a bug that could cause conditional logic to break when labels contained long strings of HTML.
*Changes:*
* Updating the JS so that when an element is shown/hidden, a jQuery event is fired after the show/hide is complete.
* Removed old licensing file.
= 1.1 =
*Bugs:*
* Fixed a bug that caused the "Change Value" conditional action to fail in some cases.
* Fixed a bug that prevented conditionals from working properly with hidden fields.
* Fixed several PHP Notices.
= 1.0.10 =
*Bugs:*
* Fixed a bug that prevented calculations from working properly when a field that the calculation was based upon was hidden with conditional logic.
= 1.0.9 =
*Changes:*
* Added a "visible" data attribute.
* Moved functions from Ninja Forms core to this extension.
*Bugs:*
* Fixed several bugs related to using calculation fields and conditionals.
= 1.0.8 =
*Changes:*
* Changed the license and auto-update system to the one available in Ninja Forms 2.2.47.
= 1.0.7 =
*Changes:*
* Changed references to wpninjas.com to ninjaforms.com.
= 1.0.6 =
*Bugs:*
* Fixed a bug that prevented conditionals from working properly in some installs.
= 1.0.5 =
* Fixed a bug that caused Conditionals to break calculation fields if they were hidden.
= 1.0.4 =
*Changes:*
* Updates for compatibility with WordPress 3.6
= 1.0.3 =
*Bugs:*
* Fixed a bug that prevented conditionals from working properly with calculation fields.
= 1.0.2 =
*Bugs:*
* Fixed a bug that caused conditionals with multiple criteria to fail when connected with the "All" parameter.
= 1.0.1 =
*Changes:*
* The Conditionals Extension can now be used with the Multi-Part Extension to show or hide entire pages.
= 1.0 =
*Bugs:*
* Fixed a bug that was causing dropdown list fields to work improperly with Conditional Logic.
= 0.9 =
*Bugs:*
* Fixed a bug that prevented conditionals from working properly with multi-checkbox lists and multi-radio button lists.
= 0.8 =
*Changes:*
* Changed the display JS slightly to be more efficient.
= 0.7 =
*Bugs:*
* Conditional fields should now behave as expected when editing user submissions.
= 0.6 =
*Bugs:*
* Fixed a bug that prevented conditionals from working properly with checkbox and radio list types.
= 0.5 =
*Changes:*
* Moved a JS function from ninja-forms-conditionals-admin.js to the ninja-forms-admin.js.
= 0.4 =
* Fixed a bug that prevented multiple forms with conditionals from being placed on the same page.
= 0.3 =
* Various bug fixes including:
* Adding multiple forms with conditions to a single page will now work normally.
= 0.2 =
* Various bug fixes.
* Changed the way that javascript and css files are loaded in extensions.