| 1 |
=== HTML Forms === |
| 2 |
Contributors: Ibericode, DvanKooten, hchouhan, lapzor |
| 3 |
Donate link: https://htmlforms.io/#utm_source=wp-plugin-repo&utm_medium=html-forms&utm_campaign=donate-link |
| 4 |
Tags: form, contact form, email, contact, contact form 7 |
| 5 |
Requires at least: 4.5 |
| 6 |
Tested up to: 4.9.6 |
| 7 |
Stable tag: 1.3.1 |
| 8 |
License: GPLv2 or later |
| 9 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 |
Requires PHP: 5.3 |
| 11 |
|
| 12 |
Not just another contact form plugin. |
| 13 |
|
| 14 |
== Description == |
| 15 |
|
| 16 |
With [HTML Forms](https://htmlforms.io/#utm_source=wp-plugin-repo&utm_medium=html-forms&utm_campaign=plugin-description), you can easily add multi-purpose forms to your WordPress site. |
| 17 |
|
| 18 |
The idea behind HTML Forms is different than most other form builder plugins. **You manage the form HTML. The plugin manages the PHP and JavaScript**. |
| 19 |
|
| 20 |
That's right. No intuitive drag & drop interface but full control over the form HTML. No limitations. |
| 21 |
|
| 22 |
We believe that dynamic form builders can be great, but they also severely limit your options. Also, they're slow. |
| 23 |
|
| 24 |
HTML Forms aims to be simpler, faster and smarter. |
| 25 |
|
| 26 |
You define your form fields in HTML and the plugin takes care of submitting the form, saving the form submission and running a configurable set of form actions. |
| 27 |
|
| 28 |
> ### 1. Define your form fields |
| 29 |
> You can use anything that resembles valid HTML. Ensure all `input` elements in your form have a `name` attribute to save 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 |
> You can 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 form HTML. 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://kb.htmlforms.io/javascript-events/#utm_source=wp-plugin-repo&utm_medium=html-forms&utm_campaign=plugin-description) and WordPress hooks that allow you to modify or extend the plugin's default behavior. |
| 45 |
- Advanced features are bundled in [HTML Forms Premium](https://www.htmlforms.io/premium-features/#utm_source=wp-plugin-repo&utm_medium=html-forms&utm_campaign=plugin-description). |
| 46 |
|
| 47 |
## Who is this for? |
| 48 |
|
| 49 |
HTML Forms is for everyone that wants a flexible & high performing form solution. |
| 50 |
|
| 51 |
- Users. Managing your own site? With HTML Forms, you don't need any technical knowledge to setup a contact form. |
| 52 |
- Developers. Building a site for your client? You supply the form HTML, HTML Forms takes care of validating and processing the form. |
| 53 |
- 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. |
| 54 |
|
| 55 |
With HTML Forms you can create any type of form. Contact forms, registration forms, price quote forms, you name it. It's somewhat similar to Contact Form 7, but without yet another template language for you to learn. |
| 56 |
|
| 57 |
For more information, please refer to [htmlforms.io](https://htmlforms.io/#utm_source=wp-plugin-repo&utm_medium=html-forms&utm_campaign=plugin-description). |
| 58 |
|
| 59 |
#### Support |
| 60 |
|
| 61 |
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. If you found a bug, please create an issue on Github where we can act upon them more efficiently. |
| 62 |
|
| 63 |
The [HTML Forms knowledge base](https://kb.htmlforms.io/#utm_source=wp-plugin-repo&utm_medium=html-forms&utm_campaign=plugin-description) covers a wide range of frequently asked questions and is updated on a regular basis. |
| 64 |
|
| 65 |
#### Development |
| 66 |
|
| 67 |
HTML Forms is being developed on GitHub. If you want to collaborate, please look at [ibericode/html-forms](https://github.com/ibericode/html-forms). |
| 68 |
|
| 69 |
|
| 70 |
== Installation == |
| 71 |
|
| 72 |
1. In your WordPress admin panel, go to *Plugins > New Plugin*, search for **HTML Forms** and click "*Install now*" |
| 73 |
1. Alternatively, download the plugin and upload the contents of `html-forms.zip` to your plugins directory, which usually is `/wp-content/plugins/`. |
| 74 |
1. Activate the plugin |
| 75 |
|
| 76 |
For more information, please refer to the [HTML Forms Knowledge Base](https://kb.htmlforms.io/#utm_source=wp-plugin-repo&utm_medium=html-forms&utm_campaign=installation-instructions). |
| 77 |
|
| 78 |
== Frequently Asked Questions == |
| 79 |
|
| 80 |
#### Where can I find help? |
| 81 |
Start by going through the [HTML Forms knowledge base](https://kb.htmlforms.io/#utm_source=wp-plugin-repo&utm_medium=html-forms&utm_campaign=plugin-faq) where we cover a wide range of frequently asked questions. |
| 82 |
|
| 83 |
#### How to display a form in posts or pages? |
| 84 |
Use the `[hf_form]` shortcode. |
| 85 |
|
| 86 |
#### How to display a form in widget areas like the sidebar or footer? |
| 87 |
Go to **Appearance > Widgets**, add the "Text Widget" to any of your widget areas and use the `[hf_form]` shortcode. |
| 88 |
|
| 89 |
#### How do I show a form in a pop-up? |
| 90 |
|
| 91 |
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. |
| 92 |
|
| 93 |
#### Can I send an email when the form is submitted? |
| 94 |
|
| 95 |
Yes! You can configure this by opening up the "Actions" tab when editing your form and clicking the "Email" button under "Available actions". |
| 96 |
|
| 97 |
### Does the plugin include anti-spam measures? |
| 98 |
|
| 99 |
The plugin comes with built-in spam protection that should stop all automated attacks, unless specifically targeted at your site. When the built-in protection doesn't cut it, [WPBruiser](https://wordpress.org/plugins/goodbye-captcha/) surely will. |
| 100 |
|
| 101 |
|
| 102 |
== Screenshots == |
| 103 |
|
| 104 |
1. Overview of forms in HTML Forms. |
| 105 |
2. Editing form fields. |
| 106 |
3. Sending an email when a form is submitted. |
| 107 |
4. Viewing saved form submissions. |
| 108 |
5. Hide form or redirect to URL after form submission. |
| 109 |
6. Configurable form messages. |
| 110 |
7. Details of a specific form submission. |
| 111 |
|
| 112 |
|
| 113 |
== Changelog == |
| 114 |
|
| 115 |
|
| 116 |
#### 1.3.1 - June 12, 2018 |
| 117 |
|
| 118 |
**Improvements** |
| 119 |
|
| 120 |
- Format dates, files and arrays when using data variables. |
| 121 |
- Format dates, files and arrays on the submissions overview and submissions details pages. |
| 122 |
- Allow cancelling a form's submit event in JavaScript (with `event.stopPropagation()`) to prevent form submission. |
| 123 |
|
| 124 |
|
| 125 |
#### 1.3.0 - May 28, 2018 |
| 126 |
|
| 127 |
**Fixes** |
| 128 |
|
| 129 |
- PHP notice because of namespace import outside of any namespace. |
| 130 |
- Removed usage of PHP 5.4+ feature. |
| 131 |
- Enforce HTTPS in form preview iframe when WP Admin uses HTTPS but public site does not. |
| 132 |
|
| 133 |
**Improvements** |
| 134 |
|
| 135 |
- Hook into GDPR Personal Data Export & Erase functionality. Requires WP 4.9.6. |
| 136 |
- Allow updating stored Submissions with empty values. [Allows clearing out IP address & user agents](https://github.com/ibericode/html-forms-code-snippets/blob/master/do-not-store-ip-address-and-user-agent.php). |
| 137 |
- Internal field should start with underscore to hide it in column view. |
| 138 |
- Add for attribute to generated label element. Allows for simple [multi-step forms](https://github.com/ibericode/html-forms-code-snippets/blob/master/multi-step-form.html). |
| 139 |
|
| 140 |
**Additions** |
| 141 |
|
| 142 |
- Add support for button clicks in conditional element logic. |
| 143 |
|
| 144 |
|
| 145 |
#### 1.2.0 - April 24, 2018 |
| 146 |
|
| 147 |
**Fixes** |
| 148 |
|
| 149 |
- Remove use of short-array syntax, which is only available in PHP 5.4 or later. |
| 150 |
|
| 151 |
**Improvements** |
| 152 |
|
| 153 |
- You can now hide columns on the submissions tab using screen options (in the top right corner). |
| 154 |
- You can now disable saving submissions on a per-form basis. |
| 155 |
- Allow pre-checking multiple checkboxes when using the field helper |
| 156 |
- Fields with matching URL parameter names will automatically be prefilled. |
| 157 |
- Use SVG icon in admin menu. |
| 158 |
|
| 159 |
**Additions** |
| 160 |
|
| 161 |
- Add simple action for subscribing to MailChimp. Requires [MailChimp for WordPress](https://wordpress.org/plugins/mailchimp-for-wp/). |
| 162 |
|
| 163 |
|
| 164 |
#### 1.1.5 - April 9, 2018 |
| 165 |
|
| 166 |
**Fixes** |
| 167 |
|
| 168 |
- Conditionally hidden fields are now ignored in server-side required field validation too. Thanks [Jeroen Sormani](https://github.com/JeroenSormani)! |
| 169 |
|
| 170 |
**Improvements** |
| 171 |
|
| 172 |
- Added foundational stuff for being able to handle file uploads. |
| 173 |
|
| 174 |
**Additions** |
| 175 |
|
| 176 |
- Added `hf_process_form` action to execute code before the form actions run. |
| 177 |
|
| 178 |
|
| 179 |
#### 1.1.4 - March 28, 2018 |
| 180 |
|
| 181 |
**Fixes** |
| 182 |
|
| 183 |
- Ensure form is fully functional in live preview. |
| 184 |
- Show all forms on the forms overview page (limit was 5). |
| 185 |
- Parse field variables in custom email headers. Thanks [Jeroen Sormani](https://github.com/JeroenSormani)! |
| 186 |
|
| 187 |
**Improvements** |
| 188 |
|
| 189 |
- You can now [bind JavaScript events](https://kb.htmlforms.io/javascript-events/) using the default browser API, eg `document.getElementById('hf-form-5').addEventListener('hf-success', ..);` |
| 190 |
- Only load JavaScript file on pages with a form on it. |
| 191 |
- Don't add line-breaks in HTML generated by the Field Builder. |
| 192 |
- [Conditional elements](https://kb.htmlforms.io/conditional-elements/) now accept wildcard values: `*` |
| 193 |
- Available field variables in email action settings are now clickable. |
| 194 |
|
| 195 |
**Additions** |
| 196 |
|
| 197 |
- Added several action & filter hooks to enable advanced functionality in [HTML Forms Premium](https://www.htmlforms.io/premium-features/). |
| 198 |
|
| 199 |
|
| 200 |
#### 1.1.3 - February 12, 2018 |
| 201 |
|
| 202 |
**Fixes** |
| 203 |
|
| 204 |
- Form preview was not working when WPML was activated. |
| 205 |
|
| 206 |
**Improvements** |
| 207 |
|
| 208 |
- Improved theme compatibility for the form preview. |
| 209 |
- Print submission details as JSON instead of PHP object. |
| 210 |
- Form messages are now added to the element as data attributes, so they can be used in JavaScript event callbacks. |
| 211 |
|
| 212 |
**Additions** |
| 213 |
|
| 214 |
- [Conditional logic](https://kb.htmlforms.io/conditional-elements/) now accepts multiple values, separated by the |-character. |
| 215 |
|
| 216 |
|
| 217 |
#### 1.1.2 - January 18, 2018 |
| 218 |
|
| 219 |
**Fixes** |
| 220 |
|
| 221 |
- Conditional elements visible in form preview. |
| 222 |
- WP_List_Table issue on forms overview page. |
| 223 |
|
| 224 |
**Improvements** |
| 225 |
|
| 226 |
- Allow disabling submission storage through a global setting. |
| 227 |
- Hide submissions tab when submission storage is disabled. |
| 228 |
- Prevent PHP notice if `$_SERVER` global is missing properties. |
| 229 |
- Update JavaScript dependencies. |
| 230 |
|
| 231 |
**Additions** |
| 232 |
|
| 233 |
- Filter: `hf_ignored_field_names` |
| 234 |
|
| 235 |
|
| 236 |
#### 1.1.1 - December 21, 2017 |
| 237 |
|
| 238 |
**Fixes** |
| 239 |
|
| 240 |
- Incorrect role capability for administrators. |
| 241 |
|
| 242 |
|
| 243 |
#### 1.1 - December 21, 2017 |
| 244 |
|
| 245 |
**Fixes** |
| 246 |
|
| 247 |
- JavaScript error in some older browser when submitting the form. |
| 248 |
|
| 249 |
**Improvements** |
| 250 |
|
| 251 |
- Use custom user capability base for editing & viewing forms. |
| 252 |
- Delay form response until a later hook so other plugins get a chance to hook in. |
| 253 |
- Disable client-side validation for conditional fields marked as required. |
| 254 |
|
| 255 |
**Additions** |
| 256 |
|
| 257 |
- Added live preview to the form editor. |
| 258 |
|
| 259 |
|
| 260 |
#### 1.0.6 - December 11, 2017 |
| 261 |
|
| 262 |
**Fixes** |
| 263 |
|
| 264 |
- Array replacements in email message were showing "Array" instead of a comma separated list of values. |
| 265 |
- Don't reset form when there are errors. Thanks [Jeroen Sormani](https://github.com/JeroenSormani)! |
| 266 |
|
| 267 |
**Additions** |
| 268 |
|
| 269 |
- You can now use certain [template variables](https://kb.htmlforms.io/template-variables/) in the form content which will be dynamically replaced. |
| 270 |
- Added `hf_validate_form_{$form_slug}` filter hook. |
| 271 |
- Added `hf_form_{$form_slug}_success` action hook. |
| 272 |
|
| 273 |
|
| 274 |
#### 1.0.5 - November 18, 2017 |
| 275 |
|
| 276 |
**Fixes** |
| 277 |
|
| 278 |
- Could not save more than one "Email" action. |
| 279 |
|
| 280 |
|
| 281 |
#### 1.0.4 - November 10, 2017 |
| 282 |
|
| 283 |
**Fixes** |
| 284 |
|
| 285 |
- Incompatibility with PHP versions before 5.6. |
| 286 |
- Data variables could not be placed on the same line. |
| 287 |
|
| 288 |
**Improvements** |
| 289 |
|
| 290 |
- Clear output buffer before sending AJAX response to prevent issues with response parsing. |
| 291 |
|
| 292 |
**Additions** |
| 293 |
|
| 294 |
- Added `hf_form_message_{$code}` filter hook. |
| 295 |
|
| 296 |
|
| 297 |
|
| 298 |
#### 1.0.3 - November 6, 2017 |
| 299 |
|
| 300 |
**Additions** |
| 301 |
|
| 302 |
- Added [support for conditional elements](https://kb.htmlforms.io/conditional-elements/) by using `data-show-if` and `data-hide-if` attributes. |
| 303 |
|
| 304 |
**Improvements** |
| 305 |
|
| 306 |
- Accept `id` argument in `[hf_form]` shortcode. |
| 307 |
- Catch errors in shortcode's `slug` attribute. |
| 308 |
- Allow changing form slug after initial form is saved. |
| 309 |
|
| 310 |
**Fixes** |
| 311 |
|
| 312 |
- Fixes stylesheet URL when option to load stylesheet is toggled. |
| 313 |
|
| 314 |
|
| 315 |
|
| 316 |
#### 1.0.2 - October 30, 2017 |
| 317 |
|
| 318 |
**Fixes** |
| 319 |
|
| 320 |
- Form validation always failing when form has 0 required fields. |
| 321 |
|
| 322 |
**Improvements** |
| 323 |
|
| 324 |
- Fake success response when honeypot validation fails. |
| 325 |
- Validate request by comparing size of POST array with number of form fields. |
| 326 |
- Ensure submit button never has label element when using the field helper. |
| 327 |
- Optimize URL generation of asset files on frontend. |
| 328 |
|
| 329 |
**Additions** |
| 330 |
|
| 331 |
- Added `hf_validate_form_request_size` filter hook. |
| 332 |
|
| 333 |
|
| 334 |
#### 1.0.1 - October 28, 2017 |
| 335 |
|
| 336 |
**Improvements** |
| 337 |
- Added SVG admin menu icon. |
| 338 |
- Field names are now sanitized before they are saved in the database. |
| 339 |
- Submit button was missing for default form fields. |
| 340 |
- Unneeded `<form>` tags are now stripped from the form before saving. |
| 341 |
|
| 342 |
**Additions** |
| 343 |
- Added `data-title` and `data-slug` attributes to the `<form>` element on the frontend. |
| 344 |
|
| 345 |
|
| 346 |
#### 1.0 - October 25, 2017 |
| 347 |
|
| 348 |
Introducing a first version of HTML Forms, a different approach to forms for WordPress sites. |
| 349 |
|
| 350 |
|
| 351 |
|
| 352 |
== Upgrade Notice == |
| 353 |
|
