PluginProbe
HTML Forms – Simple WordPress Forms Plugin / 1.7.0
HTML Forms – Simple WordPress Forms Plugin v1.7.0
1.7.0 trunk 1.0 1.0.1 1.0.2 1.0.3 1.0.4 1.0.5 1.0.6 1.1 1.1.1 1.1.2 1.1.3 1.1.4 1.1.5 1.2.0 1.3.0 1.3.1 1.3.10 1.3.11 1.3.12 1.3.13 1.3.14 1.3.15 1.3.16 All 67 releases
html-forms / readme.txt

readme.txt in HTML Forms – Simple WordPress Forms Plugin 1.7.0, at readme.txt

679 lines 21.6 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 === HTML Forms - Simple WordPress Forms Plugin ===
2 Contributors: linksoftware
3 Donate link: https://htmlformsplugin.com/
4 Tags: form, contact form, html form, email form, upload form
5 Author: HTML Forms
6 Author URI: https://htmlformsplugin.com/
7 Requires at least: 4.6
8 Tested up to: 7.1
9 Stable tag: 1.7.0
10 License: GPLv3 or later
11 License URI: http://www.gnu.org/licenses/gpl-3.0.html
12 Requires PHP: 5.3
13
14 A simpler, faster, and smarter WordPress forms plugin.
15
16 == Description ==
17
18 With [HTML Forms](https://htmlformsplugin.com/), you can easily add multi-purpose forms to your WordPress site.
19
20 The idea behind HTML Forms is different than most other form builder plugins: **You manage the form HTML. The plugin manages the PHP and a tiny bit of JavaScript**.
21
22 That's right. No "intuitive" drag & drop interface. We believe that dynamic form builders can be great, but they also severely limit your options. Also, they're slow and overly complicated from a technical point of view.
23
24 HTML Forms aims to be simpler, faster and smarter. It's the ideal plugin solution for developers looking for a simple way to create a contact form or other HTML form.
25
26 You define your form fields in HTML and the plugin takes care of submitting the form, saving the data and running a configurable set of form actions.
27
28 > ### 1. Define your form fields
29 > You can use anything that is valid HTML. Just ensure all `input` elements in your form have a `name` attribute to save the data entered in that field.
30 > ### 2. Configure your form actions
31 > By default, form submissions are automatically saved for you. You can configure several other actions to run when a form is submitted, like sending an email notification or subscribing to Mailchimp.
32 > ### 3. Show the form somewhere on your site
33 > Show your form by using the `[hf_form]` shortcode in your WordPress posts, pages or widget areas.
34
35 ## HTML Forms Features
36
37 - Full control over the HTML for the form fields. If you want, we'll help you in generating the field HTML though.
38 - Each form submission is automatically saved in your database and can be viewed in a simple table format.
39 - Configure an unlimited amount of actions to run when a form is successfully submitted. For example, sending out email notifications.
40 - Access form field values by referencing the field name, eg `[NAME]` or `[EMAIL]`.
41 - Hide form or redirect to URL after a successful submission.
42 - Configurable & translatable form messages.
43 - Field validation.
44 - Developer friendly. HTML Forms comes with a myriad of [JavaScript events](https://htmlformsplugin.com/kb/javascript-events/) and WordPress hooks that allow you to modify or extend the plugin's default behavior.
45
46 ## The Perfect WordPress Form Plugin For Everyone
47
48 HTML Forms is for everyone that wants a flexible & high performing form solution.
49
50 - Users. Managing your own site? With HTML Forms, you don't need any technical knowledge to setup a contact form.
51 - Developers. Building a site for your client? You supply the form HTML, HTML Forms takes care of validating and processing the form.
52 - Theme developers. Shipping a theme? HTML Forms allows for complete blend-in with your theme, and you don't have to write yet another contact form plugin.
53
54 With HTML Forms you can create any type of form. A contact form, email form, registration form, price quote form, you name it.
55
56 For more information, please visit [htmlformsplugin.com](https://htmlformsplugin.com/).
57
58 ## HTML Forms Premium
59
60 HTML Forms Premium is a paid add-on that extends the functionality of the free plugin. It includes:
61
62 - Submission Notifications
63 - File Uploads
64 - Webhooks
65 - Submission Export
66 - Submission Limits
67 - Require Users to Log In
68 - Data and Column Management
69 - and more...
70
71 For additional information, please visit [htmlformsplugin.com/premium](https://htmlformsplugin.com/premium).
72
73 ### Support
74
75 The [HTML Forms knowledge base](https://htmlformsplugin.com/kb/) covers a wide range of frequently asked questions.
76
77 Use the [WordPress.org plugin forums](https://wordpress.org/support/plugin/html-forms) for community support where we try to help all of our users.
78
79 ### Contributing
80
81 You can contribute to HTML Forms in various ways. For example:
82
83 - Write about the plugin on your blog or share it on social media.
84 - [Translate the plugin into your language](https://translate.wordpress.org/projects/wp-plugins/html-forms/stable/) using your WordPress.org account.
85
86 == Installation ==
87
88 1. In your WordPress admin panel, go to *Plugins > New Plugin*, search for **HTML Forms** and click "*Install now*"
89 1. Alternatively, download the plugin and upload the contents of `html-forms.zip` to your plugins directory, which usually is `/wp-content/plugins/`.
90 1. Activate the plugin
91
92 For more information, please refer to the [HTML Forms Knowledge Base](https://htmlformsplugin.com/kb/#utm_source=wp-plugin-repo&utm_medium=html-forms&utm_campaign=installation-instructions).
93
94 == Frequently Asked Questions ==
95
96 #### Where can I find help?
97 Start by going through the [HTML Forms knowledge base](https://htmlformsplugin.com/kb/#utm_source=wp-plugin-repo&utm_medium=html-forms&utm_campaign=plugin-faq) where we cover a wide range of frequently asked questions.
98
99 #### How to display a form in posts or pages?
100 Use the `[hf_form]` shortcode or the included block, in the block editor, to embed your form.
101
102 #### How to display a form in widget areas like the sidebar or footer?
103 Go to **Appearance > Widgets**, add the "Text Widget" to any of your widget areas and use the `[hf_form]` shortcode.
104
105 #### How do I show a form in a pop-up?
106
107 We recommend the [Boxzilla pop-up plugin](https://wordpress.org/plugins/boxzilla/) for this. You can use the `[hf_form]` shortcode in your pop-up box to render any of your forms.
108
109 #### Can I send an email when the form is submitted?
110
111 Yes! You can configure this by opening up the "Actions" tab when editing your form and clicking the "Email" button under "Available actions".
112
113 ### Does the plugin include anti-spam measures?
114
115 We currently recommend using [Google reCAPTCHA v3](https://htmlformsplugin.com/kb/google-recaptcha/) or the [hCaptcha plugin](https://htmlformsplugin.com/kb/hcaptcha/).
116
117
118 == Screenshots ==
119
120 1. Overview of forms in HTML Forms.
121 2. Editing form fields.
122 3. Sending an email when a form is submitted.
123 4. Viewing saved form submissions.
124 5. Hide form or redirect to URL after form submission.
125 6. Configurable form messages.
126 7. Details of a specific form submission.
127
128
129 == Changelog ==
130
131 #### 1.7.0
132 - Improvements to the Submissions tab including sorting by Timestamp, searching and pagination.
133
134 #### 1.6.5
135 - Bug fixes.
136 - Code improvements.
137
138 #### 1.6.4
139 - Minor change to Google reCAPTCHA v3 implementation for features in HTML Forms Premium 1.7.0.
140
141 #### 1.6.3
142 - Bug fix for File Uploads field display.
143
144 #### 1.6.2
145 - Bug fix for PHP deprecation notice.
146
147 #### 1.6.1
148 - Bug fix for File Uploads field.
149
150 #### 1.6.0
151 - Added support for Google reCAPTCHA v3 as an anti-spam solution.
152 - Added an "Enable Nonce" option to the plugin's settings.
153
154 #### 1.5.6
155 - Bug fix to prevent XSS on Send Email action interface.
156
157 #### 1.5.5
158 - Minor PHP syntax cleanup and interface change.
159
160 #### 1.5.4
161 - Minor changes to the form submission process.
162 - Improved integration with the hCaptcha for WordPress plugin.
163
164 #### 1.5.3
165 - Bug fix for shortcode.
166
167 #### 1.5.2
168 - Bug fix to prevent XSS on Referrer URL data.
169 - Interface changes.
170
171 #### 1.5.1
172 - Bug fix when getting error code responses when submission data is unavailable.
173 - Bug fix for _load_textdomain_just_in_time error when plugin text is being translated.
174 - Interface changes.
175
176 #### 1.5.0
177 - New Variables for HTML Forms Submission Data (Timestamp, User Agent, IP Address, and Referrer URL).
178 - Interface changes.
179
180 #### 1.4.2
181 - Bug fix to prevent XSS on HTML Forms list table.
182
183 #### 1.4.1
184
185 - Added hooks for HTML Forms Premium features.
186 - Added Knowledge Base links throughout.
187 - Interface changes.
188
189 #### 1.4.0
190
191 - Added a "Submissions" column to the forms table.
192 - New "Wrapper Tag" setting to configure what HTML tag wraps fields in the form editor.
193 - Added "Hide Preview" option to the form editor.
194 - Improved integration with the hCaptcha for WordPress plugin.
195 - Interface changes.
196
197 #### 1.3.34 - July 7th, 2024
198
199 - Made the Submissions tab a direct link.
200 - Raw submission data is now scrollable.
201 - Added nonce verification to bulk actions on the HTML Forms list table.
202
203 #### 1.3.33 - June 24th, 2024
204
205 - Fix for adding additional choices to the Dropdown, Checkboxes, and Radio Buttons fields.
206 - Fix to prevent XSS on form Messages.
207 - Fix for the Mailchimp action's check for an email field.
208 - Interface changes.
209
210 #### 1.3.32 - June 17th, 2024
211
212 - Better handling for line breaks in field data.
213 - Fix for the "d/m/Y" date format not being handled correctly.
214
215 #### 1.3.31 - May 20, 2024
216
217 - Interface changes.
218
219 #### 1.3.30 - Mar 7, 2024
220
221 - Run form mark-up through KSES filter if user lacks `unfiltered_html` capability.
222
223 #### 1.3.29 - Feb 6, 2024
224
225 - Fix `get_field_count()` used for anti-spam protection not correctly counting fields when attribute key came directly after a line-break. Thanks [yann1cks](https://github.com/yann1cks)!
226 - Fix `data-hide-if` attribute not updating required fields correctly. Thanks [yann1cks](https://github.com/yann1cks)!
227 - Remove unused class input from Gutenberg block. Thanks [yann1cks](https://github.com/yann1cks)!
228 - Remove use of `tlite` JS dependency.
229 - Update JS dependencies.
230
231
232 #### 1.3.28 - Sep 19, 2023
233
234 - Update browserslist to support the same set of browsers as WordPress core.
235 - Delay initializing the field builder component until the DOM has fully loaded. Fixes an issue with the file upload button (from HTML Forms Premium) not appearing.
236
237
238 #### 1.3.27 - Jun 30, 2023
239
240 - Fix PHP notice for calling `WPDB::prepare` with mixed argument types.
241 - Update JS dependencies.
242
243
244 #### 1.3.26 - Nov 15, 2022
245
246 - Add pagination to submissions overview page if there are more than 500 items to show.
247 - "Move to trash" action for submissions now properly called "Delete permanently". Thanks to [Rakesh Sabale](https://github.com/ghubrakesh).
248
249
250 #### 1.3.25 - Oct 21, 2022
251
252 This release fixes a SQL injection vulnerability where users with the administrator role could execute arbitrary SQL commands.
253 Thanks to **Nguyen Duy Quoc Khanh** via [WPScan](https://wpscan.com) for the responsible disclosure.
254
255 Other changes:
256
257 - Use default WordPress collation when creating tables. Props [bengs](https://github.com/bengs).
258
259
260 #### 1.3.24 - Sep 23, 2022
261
262 - Compatibility with Swup.js, thanks to [Sam Brown](https://github.com/sam98brown)
263 - Update JavaScript dependencies.
264
265
266 #### 1.3.23 - Mar 2, 2022
267
268 - Add support for swup.js in [conditional fields](https://htmlformsplugin.com/kb/conditional-elements/) logic.
269 - Safer support for Full-Site Editing by splitting up registering and enqueueing of JS and CSS assets.
270
271
272 #### 1.3.22 - Jun 7, 2021
273
274 - Always load minified asset files, regardless of SCRIPT_DEBUG constant.
275 - Optimize JavaScript event callbacks in form editor.
276 - Fix required fields logic for when field names have multiple spaces in them.
277 - Add action parameter to AJAX endpoint for submitting forms.
278
279
280 #### 1.3.21 - May 14, 2021
281
282 - Add multisite compatibility for storing form submissions. Thanks to [Ismail Hardoum](https://github.com/elhardoum).
283 - Fix required fields logic for fields with spaces in their name.
284 - Fix replacement variables logic for fields with spaces or special characters in their name.
285 - Add nonce verification to all URL's using `_hf_admin_action`.
286
287
288 #### 1.3.20 - May 7, 2021
289
290 - Change type of referer_url column in database to `TEXT`.
291 - Pass form object to `hf_form_markup` filter hook.
292 - Refresh form editor after navigating via tabs.
293
294
295 #### 1.3.19 - Feb 16, 2021
296
297 - Add filter for file-uploads to use direct links to file instead of WP media attachment.
298 - Fix field variables not showing correctly in available tags for email action message body.
299
300
301 #### 1.3.18 - Jan 13, 2021
302
303 - Updated JS dependencies.
304 - Change plugin domain to htmlformsplugin.com.
305
306
307 #### 1.3.17 - Dec 21, 2020
308
309 - Forms are now sortable by name on overview page.
310 - Update internal dependencies to their latest versions.
311 - Add `role="alert"` to form messages.
312 - Optimize size of public JavaScript file (25% size reduction) by rewriting some dependencies.
313 - Add filter for tabs in admin area.
314
315
316 #### 1.3.16 - May 6, 2020
317
318 - Add filter hook for successful form responses: `hf_form_response`
319 - Only try to detect WPBruiser hidden input fields whenever that plugin is activated.
320 - Stop explicitly enabling shortcodes in text widgets as this is now handled by WordPress core (as of version 4.9).
321 - Explicitly set engine and charset on submissions database table.
322
323
324 #### 1.3.14 - Nov 6, 2019
325
326 **Improvements**
327
328 - Stop using `supress_filters` argument when retrieving forms, for a possible performance improvement.
329 - Prevent extra SQL query for options when global settings have not been saved yet.
330
331
332 #### 1.3.13 - Oct 18, 2019
333
334 **Fixes**
335
336 - Special HTML characters being encoded even in plain text emails.
337
338 **Improvements**
339
340 - HTML tags are no longer stripped from field values, so forms can now accept HTML. HTML is still escaped upon display to prevent XSS.
341
342
343 #### 1.3.12 - Oct 11, 2019
344
345 Compatibility with Mailchimp for WordPress 4.6.
346
347
348 #### 1.3.11 - Sep 17, 2019
349
350 **Improvements**
351
352 - Write results from Mailchimp action to MC4WP debug log.
353
354
355 #### 1.3.10 - Sep 5, 2019
356
357 **Fixes**
358
359 - PHP warning introduced in latest update when using array fields.
360
361
362 #### 1.3.9 - Sep 2, 2019
363
364 **Fixes**
365
366 - Strip out [WPBruiser](https://wordpress.org/plugins/goodbye-captcha/) token field to prevent it from being stored.
367
368 **Improvements**
369
370 - Add filter hooks to variables inside the email action. Thanks to [Ryan Salerno](https://github.com/ryansalerno).
371
372
373 #### 1.3.8 - May 28, 2019
374
375 **Fixes**
376
377 - Invalid HTML for generated textarea tag.
378
379 **Improvements**
380
381 - Improved HTML escaping, preserve double and single quotes.
382 - Explicitly set charset of HTML emails to UTF-8 by default.
383 - Escape HTML after limiting string length, not before.
384
385
386 #### 1.3.7 - April 8, 2019
387
388 **Additions**
389
390 - Add Gutenberg block for adding shortcode to content.
391 - Add setting in field builder for the `multiple` attribute on `<select>` elements.
392 - Add `hf_get_forms()` function for retrieving multiple form objects.
393
394 **Improvements**
395
396 - Add `edit_form` capability to user that activates the plugin.
397
398
399 #### 1.3.6 - March 27, 2019
400
401 **Improvements**
402
403 - Don't strip HTML from variable replacements in HTML emails. This change allows you to link to uploaded files properly.
404
405
406 #### 1.3.5 - January 29, 2019
407
408 **Improvements**
409
410 - Allow adding form field variables to the form's redirect URL.
411
412
413 #### 1.3.4 - January 9, 2019
414
415 **Improvements**
416
417 - Reload available field variables when adding action on form settings page.
418 - Add role="alert" attribute to all form messages.
419 - Emit "message" event whenever message is shown to user.
420
421
422 #### 1.3.3 - November 6, 2018
423
424 **Fixes**
425
426 - Fix selected state of email content type.
427
428 **Improvements**
429
430 - Add filter & action hook for extending forms with custom messages & message settings.
431 - Don't add line-breaks automatically when using HTML emails.
432 - Delete all related postmeta when deleting a submission.
433
434
435 #### 1.3.2 - Aug 6, 2018
436
437 **Improvements**
438
439 - Default to an empty string value in conditional fields logic. This allows you to show or hide elements when a field is empty or has not been set yet.
440
441
442 #### 1.3.1 - June 12, 2018
443
444 **Improvements**
445
446 - Format dates, files and arrays when using data variables.
447 - Format dates, files and arrays on the submissions overview and submissions details pages.
448 - Allow cancelling a form's submit event in JavaScript (with `event.stopPropagation()`) to prevent form submission.
449
450
451 #### 1.3.0 - May 28, 2018
452
453 **Fixes**
454
455 - PHP notice because of namespace import outside of any namespace.
456 - Removed usage of PHP 5.4+ feature.
457 - Enforce HTTPS in form preview iframe when WP Admin uses HTTPS but public site does not.
458
459 **Improvements**
460
461 - Hook into GDPR Personal Data Export & Erase functionality. Requires WP 4.9.6.
462 - Allow updating stored Submissions with empty values. Allows clearing out IP address & user agents.
463 - Internal field should start with underscore to hide it in column view.
464 - Add for attribute to generated label element. Allows for simple multi-step forms.
465
466 **Additions**
467
468 - Add support for button clicks in conditional element logic.
469
470
471 #### 1.2.0 - April 24, 2018
472
473 **Fixes**
474
475 - Remove use of short-array syntax, which is only available in PHP 5.4 or later.
476
477 **Improvements**
478
479 - You can now hide columns on the submissions tab using screen options (in the top right corner).
480 - You can now disable saving submissions on a per-form basis.
481 - Allow pre-checking multiple checkboxes when using the field helper
482 - Fields with matching URL parameter names will automatically be prefilled.
483 - Use SVG icon in admin menu.
484
485 **Additions**
486
487 - Add simple action for subscribing to Mailchimp. Requires the [Mailchimp for WordPress plugin](https://wordpress.org/plugins/mailchimp-for-wp/).
488
489
490 #### 1.1.5 - April 9, 2018
491
492 **Fixes**
493
494 - Conditionally hidden fields are now ignored in server-side required field validation too. Thanks [Jeroen Sormani](https://github.com/JeroenSormani)!
495
496 **Improvements**
497
498 - Added foundational stuff for being able to handle file uploads.
499
500 **Additions**
501
502 - Added `hf_process_form` action to execute code before the form actions run.
503
504
505 #### 1.1.4 - March 28, 2018
506
507 **Fixes**
508
509 - Ensure form is fully functional in live preview.
510 - Show all forms on the forms overview page (limit was 5).
511 - Parse field variables in custom email headers. Thanks [Jeroen Sormani](https://github.com/JeroenSormani)!
512
513 **Improvements**
514
515 - You can now [bind JavaScript events](https://htmlformsplugin.com/kb/javascript-events/) using the default browser API, eg `document.getElementById('hf-form-5').addEventListener('hf-success', ..);`
516 - Only load JavaScript file on pages with a form on it.
517 - Don't add line-breaks in HTML generated by the Field Builder.
518 - [Conditional elements](https://htmlformsplugin.com/kb/conditional-elements/) now accept wildcard values: `*`
519 - Available field variables in email action settings are now clickable.
520
521 **Additions**
522
523 - Added several action & filter hooks to enable advanced functionality in [HTML Forms Premium](https://htmlformsplugin.com/premium-features/).
524
525
526 #### 1.1.3 - February 12, 2018
527
528 **Fixes**
529
530 - Form preview was not working when WPML was activated.
531
532 **Improvements**
533
534 - Improved theme compatibility for the form preview.
535 - Print submission details as JSON instead of PHP object.
536 - Form messages are now added to the element as data attributes, so they can be used in JavaScript event callbacks.
537
538 **Additions**
539
540 - [Conditional logic](https://htmlformsplugin.com/kb/conditional-elements/) now accepts multiple values, separated by the |-character.
541
542
543 #### 1.1.2 - January 18, 2018
544
545 **Fixes**
546
547 - Conditional elements visible in form preview.
548 - WP_List_Table issue on forms overview page.
549
550 **Improvements**
551
552 - Allow disabling submission storage through a global setting.
553 - Hide submissions tab when submission storage is disabled.
554 - Prevent PHP notice if `$_SERVER` global is missing properties.
555 - Update JavaScript dependencies.
556
557 **Additions**
558
559 - Filter: `hf_ignored_field_names`
560
561
562 #### 1.1.1 - December 21, 2017
563
564 **Fixes**
565
566 - Incorrect role capability for administrators.
567
568
569 #### 1.1 - December 21, 2017
570
571 **Fixes**
572
573 - JavaScript error in some older browser when submitting the form.
574
575 **Improvements**
576
577 - Use custom user capability base for editing & viewing forms.
578 - Delay form response until a later hook so other plugins get a chance to hook in.
579 - Disable client-side validation for conditional fields marked as required.
580
581 **Additions**
582
583 - Added live preview to the form editor.
584
585
586 #### 1.0.6 - December 11, 2017
587
588 **Fixes**
589
590 - Array replacements in email message were showing "Array" instead of a comma separated list of values.
591 - Don't reset form when there are errors. Thanks [Jeroen Sormani](https://github.com/JeroenSormani)!
592
593 **Additions**
594
595 - You can now use certain [template variables](https://htmlformsplugin.com/kb/template-variables/) in the form content which will be dynamically replaced.
596 - Added `hf_validate_form_{$form_slug}` filter hook.
597 - Added `hf_form_{$form_slug}_success` action hook.
598
599
600 #### 1.0.5 - November 18, 2017
601
602 **Fixes**
603
604 - Could not save more than one "Email" action.
605
606
607 #### 1.0.4 - November 10, 2017
608
609 **Fixes**
610
611 - Incompatibility with PHP versions before 5.6.
612 - Data variables could not be placed on the same line.
613
614 **Improvements**
615
616 - Clear output buffer before sending AJAX response to prevent issues with response parsing.
617
618 **Additions**
619
620 - Added `hf_form_message_{$code}` filter hook.
621
622
623
624 #### 1.0.3 - November 6, 2017
625
626 **Additions**
627
628 - Added [support for conditional elements](https://htmlformsplugin.com/kb/conditional-elements/) by using `data-show-if` and `data-hide-if` attributes.
629
630 **Improvements**
631
632 - Accept `id` argument in `[hf_form]` shortcode.
633 - Catch errors in shortcode's `slug` attribute.
634 - Allow changing form slug after initial form is saved.
635
636 **Fixes**
637
638 - Fixes stylesheet URL when option to load stylesheet is toggled.
639
640
641
642 #### 1.0.2 - October 30, 2017
643
644 **Fixes**
645
646 - Form validation always failing when form has 0 required fields.
647
648 **Improvements**
649
650 - Fake success response when honeypot validation fails.
651 - Validate request by comparing size of POST array with number of form fields.
652 - Ensure submit button never has label element when using the field helper.
653 - Optimize URL generation of asset files on frontend.
654
655 **Additions**
656
657 - Added `hf_validate_form_request_size` filter hook.
658
659
660 #### 1.0.1 - October 28, 2017
661
662 **Improvements**
663 - Added SVG admin menu icon.
664 - Field names are now sanitized before they are saved in the database.
665 - Submit button was missing for default form fields.
666 - Unneeded `<form>` tags are now stripped from the form before saving.
667
668 **Additions**
669 - Added `data-title` and `data-slug` attributes to the `<form>` element on the frontend.
670
671
672 #### 1.0 - October 25, 2017
673
674 Introducing a first version of HTML Forms, a different approach to forms for WordPress sites.
675
676
677
678 == Upgrade Notice ==
679