readme.txt 37.9 KB
Newer Older
1 2
=== Ninja Forms - The Easy and Powerful Forms Builder ===
Contributors: wpninjasllc, kstover, jameslaws, kbjohnson90, klhall1987, krmoorhouse, jmcelhaney, wpnzach
Kevin Stover's avatar
Kevin Stover committed
3
Tags: form, forms, contact form, custom form, form builder, form creator, form manager, form creation, contact forms, custom forms, forms builder, forms creator, forms manager, forms creation, form administration,
4 5
Requires at least: 4.7
Tested up to: 4.9
KR Moorhouse's avatar
KR Moorhouse committed
6
Stable tag: 3.2.6
Kevin Stover's avatar
Kevin Stover committed
7 8
License: GPLv2 or later

Garrett Hyder's avatar
Garrett Hyder committed
9
Drag and drop fields in an intuitive UI to create contact forms, email subscription forms, order forms, payment forms, send emails and more!
Kevin Stover's avatar
Kevin Stover committed
10 11

== Description ==
Zachary A Skaggs's avatar
Zachary A Skaggs committed
12
Ninja Forms is the ultimate FREE form creation tool for WordPress. Build forms within minutes using a simple yet powerful drag-and-drop form creator. For beginners, quickly and easily design complex forms with absolutely no code. For developers, utilize built-in hooks, filters, and even custom field templates to do whatever you need at any step in the form building or submission using Ninja Forms as a framework.
Kevin Stover's avatar
Kevin Stover committed
13

14
**Features of Ninja Forms include, but are not limited to:**
Kevin Stover's avatar
Kevin Stover committed
15

Zachary A Skaggs's avatar
Zachary A Skaggs committed
16 17 18 19 20 21
* A gorgeous and intuitive user interface.
* NO LIMITATIONS on the number of forms, fields, emails, actions, or submissions.
* Dedicated, easy to use fields for emails, dates (w/ datepicker), phone numbers, addresses and more
* Modify your own field then save them as favorites to re-use later (even in other forms!)
* Force required fields and correct data formatting with custom input masks
* Give your users a success message or redirect them elsewhere after they complete a form.
Kevin Stover's avatar
Kevin Stover committed
22 23
* Manage, Edit, and Export form user submissions.
* Export and Import forms and favorite fields.
Zachary A Skaggs's avatar
Zachary A Skaggs committed
24 25 26 27
* Email form data to administrators and/or users every time a form is processed.
* Customize emails and add raw HTML(for photos, videos, and more) with the powerful Summernote HTML editor.
* Several anti-spam options including Google reCaptcha, question/response fields, and honeypot fields
* Form submission via AJAX, allowing a seamless user experience without page refreshes
Kevin Stover's avatar
Kevin Stover committed
28 29
* Please note that if you are using a version of PHP lower than 5.3, you may experience some problems using AJAX Submissions. These can be minimized by using simple success/error messages without any quotes or special characters.

30 31 32 33 34 35 36 37 38 39
More information at [ninjaforms.com](https://ninjaforms.com/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Home+Page)

= Ninja Forms also has a complete library of add-ons to take your forms to new heights: =

**Increase form conversions**

[Breaking forms into smaller parts](https://ninjaforms.com/extensions/mult-part-forms/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Multi-Part+Forms) or [allowing users to save and return](https://ninjaforms.com/extensions/save-progress/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Save+Progress) make longer forms less intimidating. [Conditional Logic](https://ninjaforms.com/extensions/conditional-logic/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Conditional+Logic) will allow you to show field only to users who need them and send emails or process actions only under specific conditions.

Beautiful forms convert better than crowded unorganized forms. While Ninja Forms looks great on any well styled theme and is easy to style further if your are comforatble with CSS, [Layout and Styles](https://ninjaforms.com/extensions/layout-styles/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Layout+and+Styles) makes it easy to create columns for your forms as well as style specific elements.

Zachary A Skaggs's avatar
Zachary A Skaggs committed
40
**Build your mailing list**
41 42 43

Use the mailing list tool of your choice. [MailChimp](https://ninjaforms.com/extensions/mail-chimp/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=MailChimp), [Constant Contact](https://ninjaforms.com/extensions/constant-contact/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Constant+Contact), [Campaign Monitor](https://ninjaforms.com/extensions/campaign-monitor/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Campaign+Monitor), [Emma](hhttps://ninjaforms.com/extensions/emma/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Emma), [Aweber](https://ninjaforms.com/extensions/aweber/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Aweber), [MailPoet](https://ninjaforms.com/extensions/mailpoet/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=MailPoet), [iContact](https://ninjaforms.com/extensions/icontact/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=iContact), [GetResponse](https://ninjaforms.com/extensions/getresponse/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=GetResponse), [CleverReach](https://ninjaforms.com/extensions/cleverreach/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=CleverReach), [Sendy](https://ninjaforms.com/extensions/sendy/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Sendy), and [Mad Mimi](https://ninjaforms.com/extensions/mad-mimi/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Mad+Mimi) are all supported for your list building needs.

Zachary A Skaggs's avatar
Zachary A Skaggs committed
44
**Collect payments**
45 46

Ninja Forms gives you the ability to collect payments through [PayPal Express](https://ninjaforms.com/extensions/paypal-express/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=PayPal+Express), [Stripe](https://ninjaforms.com/extensions/stripe/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Stripe), or [Elavon](https://ninjaforms.com/extensions/elavon/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Elavon). More payment gateways coming.
Kevin Stover's avatar
Kevin Stover committed
47

48
**All the best customer relationship management integrations**
Kevin Stover's avatar
Kevin Stover committed
49

50
When someone fills out your form the most natural thing to do is send their data directly to your favorite CRM. Ninja Forms makes this easy with plenty of CRM integrations such as [SalesForce](https://ninjaforms.com/extensions/salesforce-crm/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=SalesForce+CRM), [Batchbook](https://ninjaforms.com/extensions/batchbook-crm/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Batchbook+CRM), [Zoho](https://ninjaforms.com/extensions/zoho-crm/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Zoho+CRM), [Insightly](https://ninjaforms.com/extensions/insightly-crm/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Insightly+CRM), [Capsule](https://ninjaforms.com/extensions/capsule-crm/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Capsule+CRM), etc.
Kevin Stover's avatar
Kevin Stover committed
51

52
**Send data to all your favorite productivity tools with the click of a submit button**
Kevin Stover's avatar
Kevin Stover committed
53

54 55 56 57 58 59 60 61 62 63
We love and use tools like [Slack](https://ninjaforms.com/extensions/slack/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Slack), [Trello](https://ninjaforms.com/extensions/trello/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Trello), and [Zapier](https://ninjaforms.com/extensions/zapier/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Zapier). These tools help our very own team build Ninja Forms so it makes sense that we would share them with you.

Even if your team needs a support form where your customers can ask for help, Ninja Forms integrates with [Help Scout](https://ninjaforms.com/extensions/help-scout/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Help+Scout) to make this a delightful experience.

**Even more add-ons available right now**

With over 40 add-ons available and new ones being added regularly, it’s likely we have everything you’ll ever need. [Check them all out here.](https://ninjaforms.com/extensions/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Add-Ons)

= Become a Ninja Forms Member =

Zachary A Skaggs's avatar
Zachary A Skaggs committed
64
Want access to everything we offer, or perhaps just our form building toolkit "Builder PRO"?
65

Zachary A Skaggs's avatar
Zachary A Skaggs committed
66
[Find our more about our Ninja Forms Memberships here.](https://ninjaforms.com/pricing/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Developer+Membership)
67 68 69 70 71

= For Developers =

The Ninja Forms framework is on [GitHub](https://github.com/wpninjas/ninja-forms)! If you're a developer and want to help make Ninja Forms better, check it out. It's also a great resource for developers who are interested in creating add-ons for our online store.

Zachary A Skaggs's avatar
Zachary A Skaggs committed
72
If you're a developer and would like to talk about creating some premium extensions for Ninja Forms, send us an email: info@wpninjas.com.
73

Kevin Stover's avatar
Kevin Stover committed
74 75
== Screenshots ==

76 77 78 79 80
1. The most intuitive and beautiful form building experience
2. Field Options
3. Emails and Actions
4. Advanced Settings
5. Beatiful Forms Every Time!
Kevin Stover's avatar
Kevin Stover committed
81

82 83
== Frequently Asked Questions ==

84 85 86 87 88 89 90 91 92 93 94 95 96
= Where can I get support? =

Our team provides free support at <a href="https://ninjaforms.com/contact/">https://ninjaforms.com/contact/</a>.

You can find the full scope of the support we are able to provide at <a href="https://ninjaforms.com/scope-of-support/">https://ninjaforms.com/scope-of-support/</a>.

= Where can I find documentation? =

Documentation for Ninja Forms can be found at <a href="https://ninjaforms.com/documentation/">https://ninjaforms.com/documentation/</a>.

= Where can I report a bug? =

Report bugs, suggest ideas, and participate in development at <a href="https://github.com/wpninjas/ninja-forms">https://github.com/wpninjas/ninja-forms</a>.
Kevin Stover's avatar
Kevin Stover committed
97 98 99 100 101 102 103 104 105

== 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

Zachary A Skaggs's avatar
Zachary A Skaggs committed
106
Shortcodes have been re-implemented. They are used like so: [ninja_form id=#] where # is the ID number of the form you want to display.
Kevin Stover's avatar
Kevin Stover committed
107 108 109

== Use ==

110
For help and video tutorials, please visit our website: [Ninja Forms Documentation](https://ninjaforms.com/documentation/?utm_medium=referral&utm_source=wordpress.org&utm_campaign=Ninja+Forms+Readme&utm_content=Ninja+Forms+Docs)
Kevin Stover's avatar
Kevin Stover committed
111 112 113

== Upgrade Notice ==

KR Moorhouse's avatar
KR Moorhouse committed
114
= 3.2.6 (13 December 2017) =
Kevin Stover's avatar
Kevin Stover committed
115

Kevin Stover's avatar
Kevin Stover committed
116
*Bugs:*
Kevin Stover's avatar
Kevin Stover committed
117

KR Moorhouse's avatar
KR Moorhouse committed
118 119 120 121 122 123 124 125
* Submission searching should now work in WordPress version 4.8.3 and above.
* Fixed an issue that sometimes caused forms not to publish after deleting a field.
* Fixed a bug that was causing User Management to sometimes not properly set default user meta values.
* Fixed a compatibility issue with the add a form widget in PHP 7.2.
* Fixed an issue that caused Ninja Forms to crash on activation with a PHP version missing the Parser Functions package.
* Fixed a bug that sometimes caused too many database calls on pages where multiple JavaScript errors were present.
* Fixed a bug that sometimes caused a Request Entity Too Large error on form publish.
* Fixed an issue that caused the Add Form button to sometimes display improperly on smaller screens.
KR Moorhouse's avatar
KR Moorhouse committed
126
* Fixed an issue that was breaking form display when multi-select fields had no pre-selected values.
Kenny Hall's avatar
Kenny Hall committed
127 128 129

*Changes:*

KR Moorhouse's avatar
KR Moorhouse committed
130 131 132
* Added an option to ignore UTF-8 encoding on export/import, which can correct forms importing with no field data.
* Updated the format of submission dates to match that of the WordPress install.
* Updated the custom field template file path so that it should now properly pull from child themes when active.
Kevin Stover's avatar
Kevin Stover committed
133

Kevin Stover's avatar
Kevin Stover committed
134
== Changelog ==
Kevin Stover's avatar
Kevin Stover committed
135

KR Moorhouse's avatar
KR Moorhouse committed
136 137 138 139 140 141
= 3.2.6 (13 December 2017) =

*Bugs:*

* Fixed an issue that was breaking form display when multi-select fields had no pre-selected values.

KR Moorhouse's avatar
KR Moorhouse committed
142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160
= 3.2.5 (13 December 2017) =

*Bugs:*

* Submission searching should now work in WordPress version 4.8.3 and above.
* Fixed an issue that sometimes caused forms not to publish after deleting a field.
* Fixed a bug that was causing User Management to sometimes not properly set default user meta values.
* Fixed a compatibility issue with the add a form widget in PHP 7.2.
* Fixed an issue that caused Ninja Forms to crash on activation with a PHP version missing the Parser Functions package.
* Fixed a bug that sometimes caused too many database calls on pages where multiple JavaScript errors were present.
* Fixed a bug that sometimes caused a Request Entity Too Large error on form publish.
* Fixed an issue that caused the Add Form button to sometimes display improperly on smaller screens.

*Changes:*

* Added an option to ignore UTF-8 encoding on export/import, which can correct forms importing with no field data.
* Updated the format of submission dates to match that of the WordPress install.
* Updated the custom field template file path so that it should now properly pull from child themes when active.

Kenny Hall's avatar
Kenny Hall committed
161 162 163 164 165 166 167 168 169 170 171
= 3.2.4 (7 November 2017) =

*Bugs:*

* Multi-select fields can now be updated in the submission edit page.
* Modified number fields to better handle rounding numbers with decimals.

*Changes:*

* Added the GNU license file.

Kenny Hall's avatar
Kenny Hall committed
172 173 174 175 176 177
= 3.2.3 (19 October 2017) =

*Bugs:*

* Fixed a bug that caused some 2.9.x to 3.0 conversion to fail.

Kevin Stover's avatar
Kevin Stover committed
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
= 3.2.2 (12 October 2017) =

*Bugs:*

* Required field validation should now work properly with the Layout and Styles add-on. 
* The email action now removes extra comma separators from email settings like(To, BCC, CC, reply-to, and from address').
* The date range on the submissions table will now show the correct submissions for the selected dates.
* Fixed a bug that was causing form imports with extra characters at the beginning to break.
* Forms that fail to load on the front-end will now remove the loading animation from the page. 
* Calculations will display correctly on the front end in HTML fields if the Save Progress add-on is active on sites. 
* The decimal setting in calculations will no longer break if non-numeric values are input into them.
* Unique fields will no longer try to validate deleted submissions. 
* Country fields should now be sorted alphabetically in non-English languages.
* Calculations decimal setting now defaults to 2 decimal places if the setting is left empty. 
* Fixed "This is not a required field" to read "This IS a required field" in Spanish locales. 
* Added translatable text for the (of) in the input limit text. 

*Changes:*

* Created a merge tag for custom user meta. This will allow users to do things like pre-populate fields with custom user meta. 
* Added placeholder for date field.
* We now have currency support for South African Rand(ZAR). 
* Added support for setting number of rows shown on a multi-select list on the front end. 
* Created a confirm field. This will allow users to map another field on their form to it and will validate the input on the front end with the field it is mapped to. 
* Added a new merge tag for submission time. This will display the time the form was submitted.
* Added WordPress filter to disable all Ninja Forms in app sales banners.
* The merge tag selector can now be used in the body of HTML fields.

Kevin Stover's avatar
Kevin Stover committed
206 207 208 209 210 211 212 213 214 215 216
= 3.2.1 (14 September 2017) =

*Bugs:*

* Fixed a bug that caused opt-ins to show incorrectly.
* Multiple Google reCaptchas on the same page should function properly.
* Fixed the layout of description text for checkbox lists.
* New lines in rich text areas should convert properly from version 2.9.x.
* Merge Tag insertion should maintain the proper cursor position in all cases.
* Form duplication should happen much more quickly.
* Unknown field types will be removed upon upgrade to prevent forms from breaking in 3.0.
217
* Fixed several issues with converting merge tags from version 2.9.x to 3.0.
Kevin Stover's avatar
Kevin Stover committed
218 219 220 221 222 223 224 225 226

*Changes:*

* A portion of users will begin to see upgrade notices for Ninja Forms 3.0. The number of users who see this notice will increase in future releases.
* "Currency" has been added to the list of input mask options.
* Basic error logging has been added to Ninja Forms; the "Get Help" page will now show the most recently recorded errors.
* Added a setting for changing stat opt-in tracking.
* License activation errors will now show more detail.

Kevin Stover's avatar
Kevin Stover committed
227
= 3.2 (14 September 2017) =
228 229 230 231 232 233 234 235 236

*Bugs:*

* Multiple Google reCaptchas on the same page should function properly.
* Fixed the layout of description text for checkbox lists.
* New lines in rich text areas should convert properly from version 2.9.x.
* Merge Tag insertion should maintain the proper cursor position in all cases.
* Form duplication should happen much more quickly.
* Unknown field types will be removed upon upgrade to prevent forms from breaking in 3.0.
237
* Fixed several issues with converting merge tags from version 2.9.x to 3.0.
238 239 240 241 242 243 244 245

*Changes:*

* "Currency" has been added to the list of input mask options.
* Basic error logging has been added to Ninja Forms; the "Get Help" page will now show the most recently recorded errors.
* Added a setting for changing stat opt-in tracking.
* License activation errors will now show more detail.

Kevin Stover's avatar
Kevin Stover committed
246
= 3.1.9 (04 August 2017) =
247 248 249

*Bugs:*

Kevin Stover's avatar
Kevin Stover committed
250 251 252 253 254 255
* Fixed a bug that caused form submissions to fail with an NF_ESO_PARSER error.
* The nf_sub_seq_num shortcode should now be properly converted when upgrading from 2.9.x to 3.0.
* bcc and cc fields in email actions should convert properly when upgrading from 2.9.x to 3.0.
* Clicking on icons and buttons in the builder should be much more consistent.
* Scrolling in the drawer should work properly when viewing the form builder on a mobile device.
* Fixed a bug that prevented the drawer from opening when editing a duplicated list field.
256

Kevin Stover's avatar
Kevin Stover committed
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
= 3.1.8 (01 August 2017) =

*Features:*

* You can now limit form submissions based upon unique fields.

*Changes:*

* Simplified the collect payment action by making it easier to set a paymen total.
* Form titles should appear in form export filenames.
* Added a filter to submissions table view labels.
* Removed the wrapper class for the ReCaptcha field.
* WordPress date settings are now the default for datepicker fields.
* Condensed admin notices into an easier to dismiss format.
* Links to media files entered into the RTE for actions should now use the title of that media item.
* Added a confirm dialog to the rollback button.
* Term merge tags should use the term label now, rather than the ID.
* Added a minimum WordPress version check to the Get Help->System Status page.

*Bugs:*

* Fixed a bug that could cause the dashboard to fail to display.
* Updated form templates for consistency.
* Email action errors should only show to admin users who are logged-in.
* Translation of submission labels and text should work properly.
* Password fields should not save in the database.
* Empty h3 tags are no longer output when a form title is empty.
* Merge tags should work more consistently in all contexts.
* The delete animation on the dashboard should be clearer.
* Fixed conflicts with other plugins using our EOS math library.
* Created On dates for imported and duplicated forms should reflect the current date.
* Fixed a bug with calculations that could cause a NaN error in JavaScript.
* Merge tags should work properly when previewing a form with unpublished changes.

Kevin Stover's avatar
Kevin Stover committed
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
= 3.1.7 (01 August 2017) =

*Features:*

* You can now limit form submissions based upon unique fields.

*Changes:*

* Simplified the collect payment action by making it easier to set a paymen total.
* Form titles should appear in form export filenames.
* Added a filter to submissions table view labels.
* Removed the wrapper class for the ReCaptcha field.
* WordPress date settings are now the default for datepicker fields.
* Condensed admin notices into an easier to dismiss format.
* Links to media files entered into the RTE for actions should now use the title of that media item.
* Added a confirm dialog to the rollback button.
* Term merge tags should use the term label now, rather than the ID.
* Added a minimum WordPress version check to the Get Help->System Status page.

*Bugs:*

* Updated form templates for consistency.
* Email action errors should only show to admin users who are logged-in.
* Translation of submission labels and text should work properly.
* Password fields should not save in the database.
* Empty h3 tags are no longer output when a form title is empty.
* Merge tags should work more consistently in all contexts.
* The delete animation on the dashboard should be clearer.
* Fixed conflicts with other plugins using our EOS math library.
* Created On dates for imported and duplicated forms should reflect the current date.
* Fixed a bug with calculations that could cause a NaN error in JavaScript.
* Merge tags should work properly when previewing a form with unpublished changes.

324 325 326 327 328 329 330 331 332 333
= 3.1.6 (26 June 2017) =

*Bugs:*

* Fixed a bug that could cause Recurly and Stripe add-ons to fail.
* Fixed a bug with bad form titles that could cause the form dashboard to crash.
* Calculations with whitespaces should be better handled on the front-end.
* Checkbox label positioning should be correct in all setups.
* Form deletion confirmation modal should now be styled correctly.

334 335 336 337 338 339 340 341 342 343 344 345 346 347 348
= 3.1.5 (21 June 2017) =

*Bugs:*

* Empty Calculation rounding settings should now default to 2.
* Using post meta merge tags should now work with other post merge tags.
* Star Rating fields now have admin key settings.
* Form cache should now be properly removed when a field is deleted.
* The "New Form" button should now show when creating a new post or page.
* HTML fields should now show properly in merge tags.
* Fixed a bug with the LogLevel class.
* Querystring merge tags should now be empty rather than showing {querystring:foo} when no querystring is present.
* Date Created should now be more accurate in all contexts.
* Fixed a bug that could cause forms to fail to render on the front-end when themes passed content through wpautop.

Kevin Stover's avatar
Kevin Stover committed
349
= 3.1.4 (06 June 2017) =
350

Kevin Stover's avatar
Kevin Stover committed
351 352 353
*Bugs:*

* Fixed a possible memory leak that could cause the builder to crash if the settings drawer was opened multiple times.
Kyle B. Johnson's avatar
Kyle B. Johnson committed
354

Kevin Stover's avatar
Kevin Stover committed
355 356 357 358 359 360 361 362 363 364 365
= 3.1.3 (31 May 2017) =

*Bugs:*

* Users should be able to re-submit forms that fail initial anti-spam checks.
* Fixed some bugs related to calculations and submission.

*Changes:*

* Added sortable icons to the forms dashboard.

366 367 368 369 370
= 3.1.2 (16 May 2017) =

*Bugs:*

* Fixed several possible PHP notices.
Garrett Hyder's avatar
Garrett Hyder committed
371
* Fixed a possible conflict with the bbPress plugin.
372 373 374 375 376 377 378 379
* Editing submissions with Checkbox List fields should work properly.
* Product fields with costs over 1000 should now work properly.
* Fixed a bug that caused duplicate submissions if a form wasn't hidden after submission.

*Changes:*

* Forms should be sorted by title in the dashboard and the submissions page.

380 381 382 383 384 385
= 3.1.1 (02 May 2017) =

*Bugs:*

* Fixed bugs in the new Merge Tag UI that prevented it from being opened properly via clicks.

386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404
= 3.1 (02 May 2017) =

*Changes:*

* Added a dashboard view for forms, removing the "All Forms" and "Add New" submenus.
* All new Merge Tag UI for inserting Merge Tags into forms and actions.
* Refactored calculations, as well as adding an option to set calculation rounding.
* Updated the WordPress.org readme file.
* Opening the "new form" page should automatically open the drawer to add new fields.

*Bugs:*

* Fixed several bugs with calculations and locales that use non-American thousands and decimal separators.
* Products with a price over 999 should now render and calculate properly.
* Editing a submission and using a single quote should not break the submission editor.
* Fixed several PHP notices.
* After successful submission, the page should only scroll to the success message if it is not fully visible.
* Inline email validation should work properly for longer email domains, i.e. @liverpool.ac.uk

Kevin Stover's avatar
Kevin Stover committed
405 406 407 408 409 410
= 3.0.34.1 (25 April 2017) =

*Security:*

* Fixed a possible security export related to WP Sessions. Please update as soon as possible.

411 412 413 414 415 416
= 3.0.34 (18 April 2017) =

*Bugs:*

* Fixed a bug that could cause emails to fail with a 500 internal server error.

417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434
= 3.0.33 (11 April 2017) =

*Changes:*

* Added an admin warning notice if Contact Form 7 is installed.
* Users who upgrade to version 3.0 will now see an admin notice instructing them to check their converted forms.
* Added the TLS version, if installed, to the get help page.
* Fixed a bug that could cause a PHP fatal error with older, insecure versions of PHP.

*Bugs:*

* Fixed a bug that caused field labels to be output multiple times in submission exports.
* Removed several PHP Warnings related to publishing longer forms.
* Updated inline email check so that it should work on longer domains, i.e. co.uk.
* Editing submissions with single checkboxes should now save properly.
* Fields should be properly sorted in CSV files attached to emails.
* Sequential IDs for submissions on converted or imported forms should not reset.

Kevin Stover's avatar
Kevin Stover committed
435
= 3.0.32 (11 April 2017) =
436 437 438

*Changes:*

Kevin Stover's avatar
Kevin Stover committed
439 440 441
* Added an admin warning notice if Contact Form 7 is installed.
* Users who upgrade to version 3.0 will now see an admin notice instructing them to check their converted forms.
* Added the TLS version, if installed, to the get help page.
442

Kevin Stover's avatar
Kevin Stover committed
443 444 445 446 447 448 449 450
*Bugs:*

* Fixed a bug that caused field labels to be output multiple times in submission exports.
* Removed several PHP Warnings related to publishing longer forms.
* Updated inline email check so that it should work on longer domains, i.e. co.uk.
* Editing submissions with single checkboxes should now save properly.
* Fields should be properly sorted in CSV files attached to emails.
* Sequential IDs for submissions on converted or imported forms should not reset.
451

Kevin Stover's avatar
Kevin Stover committed
452 453 454 455 456 457 458 459 460 461 462 463 464
= 3.0.31 (07 March 2017) =

*Bugs:*

* Confirmed password fields should work properly.
* Fixed a bug with List Fields that caused the Import button to overlap the Add New button.
* Closed a possible security vulnerability by escaping HTML in the builder.
* CSV files should now be deleted from the server after they are emailed when attached to an email action.

*Changes:*

* Added a filter so that add-ons and custom code can add forms to the templates section of the New Form builder.

465 466 467 468 469 470 471 472 473 474 475 476
= 3.0.30 (28 February 2017) =

*Bugs:*

* Publishing a form should now populate the backup database properly in all environments.
* Editing submissions that have selects or other lists should now work properly.

*Changes:*

* Added Trello to the available actions list.
* Added a JS exception catcher to help debug when forms don't display because of JS errors.

477
= 3.0.29 (21 February 2017) =
Kyle B. Johnson's avatar
Kyle B. Johnson committed
478

479 480 481
*Bugs:*

* Fixed a bug that could cause previewed forms from submitting properly.
Kyle B. Johnson's avatar
Kyle B. Johnson committed
482

483 484 485 486 487 488 489 490 491 492 493 494 495 496 497
= 3.0.28 (21 February 2017) =

*Bugs:*

* Fixed a JS notice caused by the use of jQuery.attr() instead of jQuery.prop().
* Modified the approach to form publishing to improve performance for larger forms and prevent bugs when saving.
* Google reCaptcha should now work properly when a field has an error.

*Changes:*

* Added a jQuery event: "nfFormReady" to the document that can be used to fire JS code when a form has loaded.
* Using jQuery.val() should now properly work for Ninja Forms fields.
* Updated the update check URL for add-ons.
* Added a filter for form settings upon form display localization.

498 499 500 501 502 503
= 3.0.27 (2 February 2017) =

*Bugs:*

* Field data should populate properly in all submission exports.

Kevin Stover's avatar
Kevin Stover committed
504
= 3.0.26 (30 January 2017) =
Kyle B. Johnson's avatar
Kyle B. Johnson committed
505 506 507

*Bugs:*

Kevin Stover's avatar
Kevin Stover committed
508 509 510
* Field data should populate properly in submission exports.
* Email errors upon form submission should be clearer.
* Fixed a compatibility bug with other plugins that use the WP List Table.
Kyle B. Johnson's avatar
Kyle B. Johnson committed
511

512 513 514 515 516 517 518 519
= 3.0.26 (30 January 2017) =

*Bugs:*

* Field data should populate properly in submission exports.
* Email errors upon form submission should be clearer.
* Fixed a compatibility bug with other plugins that use the WP List Table.

520 521 522 523 524 525 526 527 528 529 530 531 532
= 3.0.25 (26 January 2017) =

*Changes:*

* Increasing the performance of submissions and form builder loading.
* Improved compatibility with popular caching plugins.

*Bugs:*

* Field tags should now properly populate in calculation merge tags.
* Submission exports should now always order properly.
* Fixed a bug with submissions exporting non-Ninja Forms data.
* Importing forms with non-UTF8 characters should now import properly.
Garrett Hyder's avatar
Garrett Hyder committed
533
* Fixed a bug with converting forms from 2.9.x to 3.0.
534

Kevin Stover's avatar
Kevin Stover committed
535 536 537 538 539 540
= 3.0.24 (15 January 2017) =

*Bugs:*

* Fixed a bug with Google reCaptcha and the deprecated, 2.9.x codebase.

Kyle Johnson's avatar
Kyle Johnson committed
541 542 543 544 545 546
= 3.0.23 (12 January 2017) =

*Bugs:*

* Fixed a bug with form duplication.

Kevin Stover's avatar
Kevin Stover committed
547 548 549 550
= 3.0.22 (11 January 2017) =

*Bugs:*

Garrett Hyder's avatar
Garrett Hyder committed
551
* Fixed a bug that caused installations to crash on older, insecure versions of PHP.
Kevin Stover's avatar
Kevin Stover committed
552

Kevin Stover's avatar
Kevin Stover committed
553 554 555 556 557 558 559 560 561 562 563 564 565 566 567
= 3.0.21 (11 January 2017) =

*Changes:*

* Added an import for list options.
* Refactored form submissions so that they are more responsive for longer forms with more submissions.
* Moved the 'reply_to' setting to the primary section in email actions.
* Added error handling for invalid "TO" email addresses.

*Bugs:*

* Fixed a bug with calculations that caused brackets to appear in calculation fields.
* On/off settings should now save properly in all situations.
* Dragging a field should now properly scroll the screen.

Kevin Stover's avatar
Kevin Stover committed
568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585
= 3.0.20 (21 December 2016) =

*Changes:*

* Added a prompt before deleting forms on the all-forms table.
* Added the ability to use: {field:name} <{field:email}> to get Name - Address formatting in email actions CC, BCC, Reply-To Field.
* Updated the third-party EDD library.
* Removed references to the modernizer library from the builder.
* Added Twilio and Videomail to the list of available actions.

*Bugs:*

* Fixed a bug that caused fields to be out of order when exporting or editing submissions.
* Product fields should now respect locale-specific number formating.
* Fixed a bug with restarting form submit. This caused issues with PayPal Express and other add-ons.
* When adding new list options, the 'value' should auto-populate from 'label' setting.
* The tab order for list options should now work properly.

Kevin Stover's avatar
Kevin Stover committed
586 587 588 589 590 591 592
= 3.0.19 (07 December 2016) =

*Bugs:*

* Product, Shipping, and Total fields should now work in all locales.
* Fixed a major bug preventing forms with date fields from showing in some instances.

593 594 595 596 597 598
= 3.0.18 (06 December 2016) =

*Bugs:*

* Fixed a bug with 3.0.17 and the deprecated code base.

599
= 3.0.17 (06 December 2016) =
Kevin Stover's avatar
Kevin Stover committed
600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623

*Bugs:*

* When using the RTE setting on the textarea field, the media button should show on all themes.
* The Modernizr library should only be loaded if you are using the RTE on the front-end.
* System date merge tag should respect the date format plugin setting.
* Exported submissions should always have correct order.
* Fixed a bug with list fields that caused the wrong one to be selected if calc values are used.
* HTML entered into field and list option labels should be rendered properly.
* Fixed a bug that caused the date picker to fail on the front-end.
* Filtering field values before display should now work properly in all instances.
* Help text should always render properly on the front-end.
* Fixed a bug with rendering the ReCaptcha field in the 2.9.x codebase.
* Error messages should work properly when displaying multiple forms on the same page.

*Changes:*

* The browser should scroll to the success message after a form is submitted.
* Added a label to the ReCaptcha field.
* Added decimal date seperators (MM.DD.YYYY, YYYY.MM.DD, etc.) to the date field setting.
* Sending initial data to api.ninjaforms.com for users who have opted in.
* Added the $sub_id data to the ninja_forms_custom_columns filter.
* Field selectors in the builder should always show the "nicename" of the field rather than the programmatic name.

Kyle B. Johnson's avatar
Kyle B. Johnson committed
624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647
= 3.0.16 (21 November 2016) =

*Bugs:*

* Fixed a bug with export values and the Country Field to show full labels as opposed to abbreviations.
* Fixed a bug with duplicate field keys when duplicating a field.
* Fixed a bug with merge tags not being replaced in actions.
* Fixed a bug with unknown field types.
* Fixed a bug with capabilities and granting access to forms and submissions.
* Fixed a bug with restricting decimal steps in the number fields ( i.e. set increments by .01 ).
* Fixed a bug with reCaptcha validation not halting the form submission.
* Fixed a bug with displaying help text on the form display.
* Fixed a bug with enqueueing the media library scripts for the rich text editor.
* Fixed a bug with the submitting button text disappearing when a form was cleared after submission.
* Fixed a bug with converting email actions with multiple emails addresses in a single setting.
* Fixed a bug with prefixing the postmeta database table with custom prefixes.
* Fixed a bug with reCaptcha not showing due to a script loading race condition.

*Changes:*

* Added an additional parameter for calculations to force 2 decimal rounding.
* Added a year range setting for the date field's datepicker.
* Added a filter to email action settings before the email is sent.

Kyle B. Johnson's avatar
Kyle B. Johnson committed
648 649 650 651 652 653 654 655 656 657
= 3.0.15 (09 November 2016) =

*Bugs:*

* Fixed a bug with custom field processing not updating field data properly.

*Changes:*

* Added better support for extensions interacting with field duplication in the builder.

658 659
= 3.0.14 (03 November 2016) =

660 661 662 663
*Bugs:*

* Fixed a bug with input masks that prevented custom masks from working properly.

664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691
*Changes:*

* Added per-form label settings under Advanced.
* Re-instated the changes and bug-fixes in version 3.0.12 (See below)

= 3.0.13 (01 November 2016) =

*Bugs:*

* Emergency release to deal with some bugs in version 3.0.12.

= 3.0.12 (01 November 2016) =

*Bugs:*

* Fixed a bug with 0 (zero) values failing required validation.
* Fixed a bug with Star Rating field values displaying in reverse order.
* Fixed a bug with Success Message showing on all forms on a page.
* Fixed a bug with the Modernizr library adding extra CSS classes to the page.
* Fixed a bug with converting the Country Field from v2.9.x to v3.x.
* Fixed a bug with repeating submission sequence numbers.

*Changes:*

* Added empty ninja_forms_get_form_by_id() function to avoid fatal errors.
* Performance enhancements for form display and submission processing for long forms.
* Added a field ID specific field class for styling.

Kyle B. Johnson's avatar
Kyle B. Johnson committed
692 693 694 695 696 697 698 699 700 701 702
= 3.0.11 (18 October 2016) =

*Bugs:*

* Fixed a bug with overly strict error catching that might stall form submission.

*Changes:*

* Updated field validation to not check required settings on unknown field types.
* Added a process to remove empty fields without field keys.

Kyle B. Johnson's avatar
Kyle B. Johnson committed
703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725
= 3.0.10 (18 October 2016) =

*Bugs:*

* Fixed a bug with non-visible fields generating empty HTML on display.
* Fixed a bug with dashicons not showing for non-logged in users.
* Fixed a bug with converting fields with 'inside' labels.
* Fixed a bug with showing custom columns in submissions per-form.
* Fixed a bug with field IDs not properly being updated on form publish.
* Fixed a bug with the country field not displaying the country list in the form.
* Fixed a bug with formatting of textareas and merge tags.
* Fixed a bug with displaying calculation values for checkboxes and merge tags.
* Fixed a bug with duplicate fields breaking the builder and form display.
* Fixed a bug with consistency and form cache data for the builder and form display.

*Changes:*

* Added a hook in the JavaScript for the Pikaday datepicker.
* Removed the Submission Post Type from the Admin Bar display.
* Excluded the Submission Post Type from public query.
* Added better error reporting for 500 Internal Server Errors for troubleshooting.
* Added a cleanup routine for duplicate fields in forms.

Kyle B. Johnson's avatar
Kyle B. Johnson committed
726 727 728 729
= 3.0.9 (12 October 2016) =

*Bugs:*

Garrett Hyder's avatar
Garrett Hyder committed
730
* Fixed a bug with loading the form builder from cache.
Kyle B. Johnson's avatar
Kyle B. Johnson committed
731

Kyle B. Johnson's avatar
Kyle B. Johnson committed
732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751
= 3.0.8 (11 October 2016) =

*Changes:*

* Fixed a typo in the Submission Date Filter.
* Added a filter (ninja_forms_display_fields) for removing fields form display.
* Added a check for misconfigured shortcodes that break output.

*Bugs:*

* Fixed a bug with exporting list fields in submissions.
* Fixed a bug with outputting extra text on the submission submenu.
* Fixed a bug with importing checkbox lists and default values.
* Fixed a bug with imported forms that contain HTML in fields.
* Fixed a bug with date field formatting.
* Fixed a bug with the builder drawer not scrolling to the top when opened.
* Fixed a bug with using hidden fields in calculations.
* Fixed a bug with refreshing newsletter lists in form actions.
* Fixed a bug with field calculation values in merge tags.

Kyle B. Johnson's avatar
Kyle B. Johnson committed
752
= 3.0.7 (06 October 2016) =
Kyle B. Johnson's avatar
Kyle B. Johnson committed
753

Kyle B. Johnson's avatar
Kyle B. Johnson committed
754 755 756
*Changes:*

* Added background processing for publishing long forms to avoid timeout errors.
Kevin Stover's avatar
Kevin Stover committed
757

Kyle B. Johnson's avatar
Kyle B. Johnson committed
758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778
= 3.0.6 (27 September 2016) =

*Changes:*

* Added the $post variable to the submission info metabox.
* Suppressed HTML fields from submission data.
* Suppressed HTML fields from all fields merge tags
* Added description text to the Rollback Setting (Advanced).
* Disabled the "Edit" page link when previewing a form.
* Added a plugin wide currency setting in place of the static currency symbol setting.

*Bugs:*

* Fixed a bug with validating email addresses (ie properly evaluate "+"s).
* Fixed a bug with browser compatibility.
* Fixed a bug with displaying column content on other post types.
* Fixed a bug with updating form submission error messages.
* Fixed a bug with creating empty settings on activation.
* Fixed a bug with column class collisions in CSS.
* Fixed a bug with field help text not displaying on the form.

779 780 781 782 783 784
= 3.0.5 (13 September 2016) =

*Bugs:*

* Fixed a bug with checking for a disabled PHP functions that might cause a fatal error.

785 786 787 788 789 790
= 3.0.4 (13 September 2016) =

*Bugs:*

* Fixed a bug with aggressive CDN caching.

Kevin Stover's avatar
Kevin Stover committed
791 792 793 794 795 796 797 798 799 800 801 802 803 804
= 3.0.3 (13 September 2016) =

*Bugs:*

* Added isInteger polyfill for IE11.
* Added deprecated functions to prevent PHP errors.
* Required fields message should now not show when the form is hidden.
* Field-specific scripts should only load when that field is present.
* Updating translatable text.
* Radio lists should no longer select an option by default.
* Conversions should be more stable.
* Text to HTML field conversion should now happen correctly.
* Fixed a conflict with Visual Composer.

Kevin Stover's avatar
Kevin Stover committed
805 806 807 808 809 810
= 3.0.2 (7 September 2016) =

*Bugs:*

* Fixed a bug that caused PHP notices to be displayed.

Kyle B. Johnson's avatar
Kyle B. Johnson committed
811 812 813 814 815 816 817 818 819 820 821
= 3.0.1 (7 September 2016) =

*Changes:*

* Add a deprecated notice for ninja_forms_get_all_forms function.

*Bugs:*

* Fixed a bug with templates.
* Fixed a bug with required field markings.

Kyle B. Johnson's avatar
Kyle B. Johnson committed
822 823 824 825
= 3.0 (6 September 2016) =

*Changes:*

Garrett Hyder's avatar
Garrett Hyder committed
826
* Release of Ninja Forms THREE