| @@ -1,234 +1,259 @@ | ||
| 1 | -=== Contact Forms by Cimatti === | |
| 2 | -Contributors: cimatti | |
| 3 | -Tags: contact form, form builder, email notifications, lead generation, form api | |
| 4 | -Requires at least: 5.9 | |
| 5 | -Tested up to: 7.0 | |
| 6 | -Stable tag: 2.2.32 | |
| 7 | -Requires PHP: 7.4 | |
| 8 | -License: GPLv2 or later | |
| 9 | -License URI: http://www.gnu.org/licenses/gpl-2.0.html | |
| 10 | - | |
| 11 | -Create accessible contact forms with drag-and-drop. WCAG 2.2 compliant with screen reader support, keyboard navigation, and clear error messages. | |
| 12 | - | |
| 13 | -== Description == | |
| 14 | - | |
| 15 | -[**Live Preview - Try it in WordPress Playground**](https://wordpress.org/plugins/contact-forms/?preview=1) (form submission is not available in the live preview) | |
| 16 | - | |
| 17 | -Forms are an essential component of any website. Contact Forms by Cimatti is the culmination of years of experience building and developing business websites of all types. Our plugin focuses on simplicity, power, and **accessibility**, helping you capture, store, and classify contacts according to their lead status. It's ideal for single-language and multilingual sites, simple blogs, or complex WordPress-powered Content Management Systems. | |
| 18 | - | |
| 19 | -= Accessibility First = | |
| 20 | -Contact Forms 2.0 is built with accessibility at its core, designed to meet **WCAG 2.2 AA** standards and comply with the **European Accessibility Act**: | |
| 21 | - | |
| 22 | -* **Screen Reader Support**: All form elements include proper ARIA labels, live regions for dynamic updates, and meaningful error announcements | |
| 23 | -* **Keyboard Navigation**: Full keyboard accessibility for all interactions, including drag-and-drop file uploads | |
| 24 | -* **Clear Error Messages**: Validation summary with clickable links to problematic fields, smooth scroll and focus management | |
| 25 | -* **Accessible Loading States**: Visual and screen reader feedback during form submission | |
| 26 | -* **Reduced Motion Support**: Respects `prefers-reduced-motion` user preference | |
| 27 | -* **High Contrast**: Error and success states designed for visibility | |
| 28 | - | |
| 29 | -= Select, Configure, and Embed Forms = | |
| 30 | -Choose the fields you require, customize on-screen messages and email responses, preview, test, and effortlessly embed forms into your posts, pages, or custom content types using shortcodes or the built-in TinyMCE button. | |
| 31 | -= Create Forms for Any Purpose = | |
| 32 | -Create as many forms as you need. Design landing pages, contact pages, invitations, job application forms with curriculum upload, customer request forms, spare part requests, and more. Utilize the "Clone" feature to avoid "reinventing the wheel" when creating new forms. | |
| 33 | -= Ready-to-Use Features = | |
| 34 | -Contact Forms by Cimatti has commonly used fields like First Name, Last Name, Address, Province, Country, Telephone, Email, Captcha, and default success messages and email notifications. Simply create a drag-and-drop form, save it, go to a post or page, and click the orange "C" icon in the WYSIWYG editor to insert a contact form into the post or page content. | |
| 35 | -= Easy to Use for Beginners = | |
| 36 | -These features make it effortless for first-time users, but the plugin's fast learning curve will soon entice you to explore its advanced features. | |
| 37 | -= Craft Superior Forms = | |
| 38 | -Don't leave anything to chance; fine-tune the entire form submission process. | |
| 39 | -= Create Reusable Fields = | |
| 40 | -Build custom fields to reuse multiple times, starting with 20 available field types, including Text Field, Text Area, Email, Autoreply Email, Checkbox, Checkbox Group, Radio Buttons, Select, Multiple Select, Hidden Value, File Upload, Captcha, Custom HTML, Password, and more. | |
| 41 | -= Customize Forms to Perfection = | |
| 42 | -Apply visual styles to your forms using options in the "Appearance" tab. Select colors, margins, button styles, and more. | |
| 43 | -= Custom Messages for Success = | |
| 44 | -Each form can have its own unique online success message. So, when a form is completed, you can provide access to a file download link, coupon information, or simply a message to confirm that the form was submitted correctly. | |
| 45 | -= Email Notifications for Administrators and Visitors = | |
| 46 | -Send email notifications to administrators, including tracking information like visitor IP, referrer, date and time of form submission, and other user properties (for a full list, see the Beginners' Guide). Send an email notification to the visitor as further confirmation that the form was filled in correctly. All email notifications can be tested in the Preview/Test Tab before publishing. | |
| 47 | - | |
| 48 | -= Data Collection and Excel Export = | |
| 49 | -All submitted data is securely stored in your WordPress database. Contacts received can be easily categorized into lead status categories and spam and tests can be easily discarded. Add notes on each contact received to keep track. | |
| 50 | - | |
| 51 | -All contact data received can be filtered, searched, and exported to Excel at any time. You can export all the data or just the data you need. The Advanced Excel Export option allows you to export to a file with ready-to-use filtering options. | |
| 52 | - | |
| 53 | -Contact Forms also includes a tracking graph in its Dashboard that displays the performance of all or each of your website forms over time. | |
| 54 | - | |
| 55 | -= Developer-Friendly API = | |
| 56 | -Contact Forms by Cimatti includes an API to assist developers in customizing and adding their own features. WordPress Filters are used to customize forms during generation, to check and validate submitted form values, to execute custom code using sent data, and to add custom tokens for messages. Read the documentation on our site for more information. | |
| 57 | -Powerful PHP Form Builder Class | |
| 58 | -Contact Forms by Cimatti utilizes a PHP form builder class to generate the forms, ensuring robust and efficient form creation and management. | |
| 59 | - | |
| 60 | -== Installation == | |
| 61 | -1. Upload `/contact-forms/` directory to the `/wp-content/plugins/` directory. | |
| 62 | -2. Activate the plugin through the 'Plugins' menu in WordPress. | |
| 63 | -3. Create one or more forms using the drag and drop interface. | |
| 64 | -4. Edit posts (or pages or custom types) and add the desired form using the "C" button in the visual editor (or using the shortcode). | |
| 65 | - | |
| 66 | -== Frequently Asked Questions == | |
| 67 | -You'll find the [FAQ on our website](http://www.cimatti.it/en/wordpress-plugins/contact-forms/faq/). | |
| 68 | - | |
| 69 | -= Where do I report security bugs found in this plugin? = | |
| 70 | -Please report security bugs found in the source code of the | |
| 71 | -Contact Forms by Cimatti plugin through the [Patchstack | |
| 72 | -Vulnerability Disclosure Program](https://patchstack.com/database/vdp/contact-forms). The | |
| 73 | -Patchstack team will assist you with verification, CVE assignment, and | |
| 74 | -notify the developers of this plugin. | |
| 75 | - | |
| 76 | -== Screenshots == | |
| 77 | -1. Accessible contact form with the default Top Labels layout. WCAG 2.2 AA compliant. | |
| 78 | -2. Create forms with drag and drop and see the result immediately in the live preview. | |
| 79 | -3. Three label layouts per form: top, side by side, or inline floating labels. | |
| 80 | -4. Drag and drop file upload with allowed extensions, date picker, and phone validation. | |
| 81 | -5. Group related fields with six border and title styles for long forms. | |
| 82 | -6. Clear error messages with a clickable validation summary and custom texts per field. | |
| 83 | -7. Track form performance over time, for all forms or each form individually. | |
| 84 | -8. Search, filter, classify by lead status, and export submissions to Excel. | |
| 85 | -9. Review each submission with details, lead status, notes, and GDPR anonymization. | |
| 86 | -10. Build your own fields once and reuse them in any form. | |
| 87 | -11. Set default messages, styling, and integrations once for all forms. | |
| 88 | - | |
| 89 | -== Changelog == | |
| 90 | - | |
| 91 | -= 2.2.32 = | |
| 92 | - | |
| 93 | -Maintenance release consolidating all changes since 2.2.4. See changelog.txt in the plugin folder for the detailed per-version history. | |
| 94 | - | |
| 95 | -**New features** | |
| 96 | - | |
| 97 | -* Fieldset group: new "Border and Title" style selector with 6 options (no border, border only, inline legend, title above, title inside, borderless with title). The fieldset border is now opt-in instead of always-on; re-enable it on existing forms via this option. | |
| 98 | -* Post select and Multiple post checkboxes fields: add `post_status=publish,private` to the custom query parameters to also list private posts. Draft and pending posts are never listed. | |
| 99 | -* Multiple post checkboxes field: the `post_type` custom query parameter now overrides the field's post type setting, matching the Post select field. | |
| 100 | -* Fields page: rebuilt as a WordPress-native list table with sortable columns, a "Used in forms" count, bulk delete, and row actions. | |
| 101 | -* Form editor: permanent "Default Submit Button" indicator at the bottom of the form area, hidden automatically when a custom submit field is present. | |
| 102 | - | |
| 103 | -**Improvements** | |
| 104 | - | |
| 105 | -* Single submission page: redesigned with a WordPress-standard two-column layout, human-readable field labels, and fully AJAX notes (add and delete without a page reload). | |
| 106 | -* Dashboard: last 10 submissions table rebuilt with sortable columns and an Actions column; 30 individual queries per page load replaced with a single query. | |
| 107 | -* Submissions list: long page URLs and referrers collapse with an expand toggle; Page and Referrer columns are clickable links; "Review" column renamed to "Open"; export buttons repositioned for better discoverability. | |
| 108 | -* Dashboard widget: now shown only to administrators, the same users who can access the plugin pages, and its statistics are cached so the dashboard loads faster on sites with many submissions. | |
| 109 | -* Admin sidebar icon: now monochrome and follows the active WordPress admin color scheme, without flashing the brand color on page load. | |
| 110 | -* Plugin Check (PCP) 2.0.0 compliance; minimum required WordPress version raised to 5.9. | |
| 111 | -* Italian and Spanish translations completed. | |
| 112 | - | |
| 113 | -**Fixes** | |
| 114 | - | |
| 115 | -* Translations no longer trigger a `_load_textdomain_just_in_time` deprecation notice on WordPress 6.7+. | |
| 116 | -* reCAPTCHA v2: on pages with two or more forms, the captcha now appears when the visitor starts filling any of the forms, not only the first one. | |
| 117 | -* Post select and Multiple post checkboxes fields: child posts are no longer dropped from the list; search by title, the `parent=`, `include=`, `child_of=` and `exclude_tree=` filters, and "load more" pagination now work correctly; lists appear in hierarchical order; the `{__post_id_*}` and `{__post_url_*}` email tokens output the correct values. | |
| 118 | -* Post select field: draft, private and pending post titles are no longer shown to site visitors, and a submitted value must match the field's post type. | |
| 119 | -* Validation summary links now scroll to and focus the correct field instead of jumping to the page top. | |
| 120 | -* Email format error no longer appears twice after a field loses focus following a previously displayed format error. | |
| 121 | -* AJAX form submission no longer changes the browser URL; non-AJAX submission sets the correct URL hash after page reload. | |
| 122 | -* Date field: fixed validation error for custom date fields with minimum or maximum date settings. | |
| 123 | -* Trashing a submission from the single-submission view now redirects correctly. | |
| 124 | -* Hidden field: the "CSS ID" setting now sets the id attribute on the hidden input element itself. | |
| 125 | -* Frontend CSS: focus styles for buttons, checkboxes and radios are scoped inside the form and no longer affect page-level styles. | |
| 126 | -* Form editor: Save/Cancel button alignment fixed; sort indicator on the Submissions column in the forms list is no longer misaligned. | |
| 127 | - | |
| 128 | -= 2.2.4 = | |
| 129 | -* Form editor: Appearance tab labels are now clickable (native label elements for accessibility). | |
| 130 | -* Form editor: Section headings use proper h2 elements with consistent styling. | |
| 131 | -* Form editor: Consistent row heights for style options; color pickers hidden when row is unchecked. | |
| 132 | -* Form editor: Labels dropdown no longer overflows its container. | |
| 133 | -* Form editor: Responsive 2-column layout at viewports narrower than 1200px with preview below full-width. | |
| 134 | -* Form editor: Fixed flash of unstyled content (FOUC) on page load. | |
| 135 | -* i18n: Italian and Spanish translations updated. | |
| 136 | - | |
| 137 | -= 2.2.3 = | |
| 138 | -* Form editor: Added "+" button on each available field to add it to the form with a single click (appends as last, scrolls into view, opens settings). | |
| 139 | -* Form editor: Hidden the expand caret from available fields list for cleaner UI. | |
| 140 | -* Form editor: Long field names now wrap to multiple lines instead of being truncated. The "+" button and expand caret remain vertically centered and always clickable. | |
| 141 | -* i18n: Added Italian translations for new UI strings. | |
| 142 | - | |
| 143 | -= 2.2.2 = | |
| 144 | -* Form editor: Added instant search filter in the Available Fields column: type to quickly find fields by name (substring match). | |
| 145 | - | |
| 146 | -= 2.2.1 = | |
| 147 | -* Form editor: Redesigned Fields tab as a stable three-column CSS Grid layout (available fields, drop zone, live preview). The available fields column has its own scrollbar; the other columns use the main browser scroll. Fixes wrapping issues on high-zoom levels, small screens, and forms with many fields or long labels. | |
| 148 | -* Form editor: Each column now has its own heading styled consistently and aligned at the same height. | |
| 149 | -* Form editor: Drop zone title moved outside the dashed border for clearer visual hierarchy. | |
| 150 | - | |
| 151 | -= 2.2.0 = | |
| 152 | -* Tested up to WordPress 7.0. | |
| 153 | -* Added WordPress Playground blueprint for live preview on wordpress.org - five demo forms covering all field types including fieldsets, checkboxes, multi-select, post-select, and HTML blocks. | |
| 154 | -* Email notifications: Long URLs no longer break print/PDF layout. Applied table-layout fixed and word-break on URL fields. | |
| 155 | -* Email notifications: Improved vertical spacing between submitted fields with proper cell padding. | |
| 156 | -* Email notifications: Fieldset labels now display correctly instead of raw field IDs. | |
| 157 | -* Email notifications: Fixed malformed font-family quotes in the email body wrapper. | |
| 158 | -* Single submission page: Restructured from 3-column to 2-column (30/70) layout. Details and Lead Status are now in the left column, submitted fields in the right. | |
| 159 | -* Single submission page: Renamed "Stats" postbox to "Details". | |
| 160 | -* Single submission page: Long URLs now wrap properly in the submitted fields table. | |
| 161 | -* Submissions list: Added view links (Active, Trash, Lead Status) for quick filtering. | |
| 162 | -* Submissions list: Refactored filter controls into native WP_List_Table extra_tablenav pattern. | |
| 163 | -* Bugfix: Fieldset without a label no longer shows a gap in the border. | |
| 164 | -* Bugfix: Essential Columns button race condition - column settings no longer lost during batch save. | |
| 165 | -* Bugfix: Fields page - legacy-format fields now display correctly with proper name/slug fallback. | |
| 166 | - | |
| 167 | -= 2.1.4 = | |
| 168 | -* Responsive sidebyside layout: labels automatically stack on top when the form container is narrower than 500px, using CSS container queries. Works across all themes regardless of viewport width. | |
| 169 | - | |
| 170 | -= 2.1.3 = | |
| 171 | -* Fixed: Post select field value was not saved to database and not included in notification emails. The submission handler now resolves posts directly instead of relying on empty lazy-loaded options. | |
| 172 | - | |
| 173 | -= 2.1.2 = | |
| 174 | -* Form editor: Added submission count with link to the submissions list, displayed inline with the page heading. | |
| 175 | -* Form editor: Title input now has proper spacing and sizing matching WordPress core post editor styling. | |
| 176 | -* Form editor: Google Ads and Tokens tabs now use WordPress postbox markup with form-table layout. | |
| 177 | -* Form editor: Added unsaved changes warning (beforeunload prompt) when the form has been modified. | |
| 178 | - | |
| 179 | -= 2.1.1 = | |
| 180 | -* Fixed single submission page: restored proper padding and spacing in the Lead status and Notes postbox | |
| 181 | -* Improved layout alignment for Lead status dropdown and help icon | |
| 182 | -* Italian: standardized terminology - "compilazione/compilazioni" for submissions, fixed mixed "modulo/moduli" back to "form/forms", translated all missing strings | |
| 183 | -* Spanish: added ~260 missing translations (Theme Helper, Appearance, Danger Zone, default messages, block editor, GDPR) | |
| 184 | - | |
| 185 | -= 2.1.0 = | |
| 186 | -Admin UI modernization with a more coherent design language aligned with native WordPress admin patterns. | |
| 187 | - | |
| 188 | -* Flat single-level tab bar for the form editor (Fields, Appearance & General, Messages, Data Retention, Google Ads, Tokens) | |
| 189 | -* Grid-based layout for form field editor and live preview | |
| 190 | -* Tab navigation on the settings page with ARIA-compliant accessible tabs | |
| 191 | -* Native WordPress postbox structure for all settings sections | |
| 192 | -* Messages tab: 2×2 grid layout, accessible radio buttons with fieldset/label, TinyMCE font selector with 10 email-safe fonts | |
| 193 | -* Default font changed from Lucida Sans to Arial for new forms | |
| 194 | -* Merged dashboard.css into admin.css, removed dead CSS selectors | |
| 195 | -* Bugfix: broken CSS selectors caused by panel ID renaming | |
| 196 | -* Bugfix: Messages, Data Retention, and Tokens panels not properly contained within the tab system | |
| 197 | - | |
| 198 | -= 2.0.0 = | |
| 199 | - | |
| 200 | -Major rewrite focused on accessibility, modern admin UI, and GDPR compliance. All existing forms continue to work without changes. | |
| 201 | - | |
| 202 | -**Important:** CSS changes (35 removed `!important` declarations) may affect frontend layouts customized via theme CSS. Use Contact Forms > Theme Helper to identify conflicts. Where possible, use the plugin's Appearance tab instead of theme CSS overrides. | |
| 203 | - | |
| 204 | -* Accessibility rewrite: WCAG 2.2 AA / European Accessibility Act compliance | |
| 205 | -* Inline Labels layout (floating labels) | |
| 206 | -* Live preview in the form editor | |
| 207 | -* GDPR data retention, anonymization, and WordPress Privacy API | |
| 208 | -* Cloudflare Turnstile support (via Simple Cloudflare Turnstile plugin) | |
| 209 | -* Google reCAPTCHA v2 with built-in key configuration | |
| 210 | -* Drag-and-drop file upload with keyboard navigation | |
| 211 | -* Telephone field with E.164 validation and country prefix | |
| 212 | -* Custom validation messages per field and per form | |
| 213 | -* Custom CSS class and ID on all field types | |
| 214 | -* Submissions list with sortable columns, row actions, and Excel export | |
| 215 | -* Dashboard charts with monthly-by-page breakdown | |
| 216 | -* Gutenberg block for inserting forms | |
| 217 | -* Settings page with Danger Zone and deactivation cleanup | |
| 218 | -* Theme Helper: diagnose CSS conflicts between your theme and Contact Forms | |
| 219 | -* English, Italian, and Spanish translations | |
| 220 | -* Plugin Check (PCP) fully compliant | |
| 221 | - | |
| 222 | -For the detailed per-beta changelog, see the plugin's changelog.txt file. | |
| 223 | - | |
| 224 | -= 1.9.14 = | |
| 225 | - | |
| 226 | -* Added Cloudflare Turnstile field integration | |
| 227 | - | |
| 228 | -== Upgrade Notice == | |
| 229 | - | |
| 230 | -= 2.2.32 = | |
| 231 | -Large maintenance release: admin UI improvements, post field fixes, faster dashboard, Plugin Check compliance. Note: fieldset borders are now opt-in. If your forms use fieldset groups, re-enable the border via the field's new "Border and Title" option. | |
| 232 | - | |
| 233 | -= 2.0.0 = | |
| 234 | -Major rewrite: accessibility (WCAG 2.2 AA), GDPR tools, new layouts, spam protection, and modern admin UI. CSS changes may affect custom theme styling -- use Theme Helper to review. All existing forms continue to work. | |
| 1 | +=== WordPress Contact Forms by Cimatti === | |
| 2 | +Contributors: cimatti | |
| 3 | +Tags: contact, form, forms, contact form, contact forms, feedback, mail, email, ajax, attachment, curriculum, contact us, custom form, excel, form builder, web form, feedback, form manager, form to email, form to database, landing page, file upload, email form, customer request, spare parts, invitations, event forms, qtranslate, w3 total cache, drag and drop, form framework, form designer, form creator, php form builder | |
| 4 | +Requires at least: 3.5 | |
| 5 | +Tested up to: 6.5.2 | |
| 6 | +Stable tag: 1.9.2 | |
| 7 | +License: GPLv2 or later | |
| 8 | +License URI: http://www.gnu.org/licenses/gpl-2.0.html | |
| 9 | + | |
| 10 | +Create and publish forms in your WordPress website with drag and drop. Contact forms, landing page forms, invitations, and more. | |
| 11 | + | |
| 12 | +== Description == | |
| 13 | +Forms are an essential component of any website. WordPress Contact Forms is the culmination of years of experience building and developing business websites of all types. Our plugin focuses on simplicity and power, it captures, stores and helps to classify contacts and leads according to their lead status. It's ideal for single-language and multilingual sites, simple blogs, or complex WordPress-powered Content Management Systems. If your website handles a considerable amount of contacts and you need to make diverse forms our plugin is an excellent choice. | |
| 14 | += Select, Configure, and Embed Forms = | |
| 15 | +Choose the fields you require, customize on-screen messages and email responses, preview, test, and effortlessly embed forms into your posts, pages, or custom content types using shortcodes or the built-in TinyMCE button. | |
| 16 | += Create Forms for Any Purpose = | |
| 17 | +Create as many forms as you need. Design landing pages, contact pages, invitations, job application forms with curriculum upload, customer request forms, spare part requests, and more. Utilize the "Clone" feature to avoid "reinventing the wheel" when creating new forms. | |
| 18 | += Ready-to-Use Features = | |
| 19 | +WordPress Contact Forms has commonly used fields like First Name, Last Name, Address, Province, Country, Telephone, Email, Captcha, and default success messages and email notifications. Simply create a drag-and-drop form, save it, go to a post or page, and click the orange "C" icon in the WYSIWYG editor to insert a contact form into the post or page content. | |
| 20 | += Easy to Use for Beginners = | |
| 21 | +These features make it effortless for first-time users, but the plugin's fast learning curve will soon entice you to explore its advanced features. | |
| 22 | += Craft Superior Forms = | |
| 23 | +Don't leave anything to chance; fine-tune the entire form submission process. | |
| 24 | += Create Reusable Fields = | |
| 25 | +Build custom fields to reuse multiple times, starting with 20 available field types, including Text Field, Text Area, Email, Autoreply Email, Checkbox, Checkbox Group, Radio Buttons, Select, Multiple Select, Hidden Value, File Upload, Captcha, Custom HTML, Password, and more. | |
| 26 | += Customize Forms to Perfection = | |
| 27 | +Apply visual styles to your forms using options in the "Appearance" tab. Select colors, margins, button styles, and more. | |
| 28 | += Custom Messages for Success = | |
| 29 | +Each form can have its own unique online success message. So, when a form is completed, you can provide access to a file download link, coupon information, or simply a message to confirm that the form was submitted correctly. | |
| 30 | += Email Notifications for Administrators and Visitors = | |
| 31 | +Send email notifications to administrators, including tracking information like visitor IP, referrer, date and time of form submission, and other user properties (for a full list, see the Beginners' Guide). Send an email notification to the visitor as further confirmation that the form was filled in correctly. All email notifications can be tested in the Preview/Test Tab before publishing. | |
| 32 | + | |
| 33 | += Data Collection and Excel Export = | |
| 34 | +All submitted data is securely stored in your WordPress database. Contacts received can be easily categorized into lead status categories and spam and tests can be easily discarded. Add notes on each contact received to keep track. | |
| 35 | + | |
| 36 | +All contact data received can be filtered, searched, and exported to Excel at any time. You can export all the data or just the data you need. The Advanced Excel Export option allows you to export to a file with ready-to-use filtering options. | |
| 37 | + | |
| 38 | +WordPress Contact Forms also includes a tracking graph in its Dashboard that displays the performance of all or each of your website forms over time. | |
| 39 | + | |
| 40 | += Developer-Friendly API = | |
| 41 | +WordPress Contact Forms includes an API to assist developers in customizing and adding their own features. WordPress Filters are used to customize forms during generation, to check and validate submitted form values, to execute custom code using sent data, and to add custom tokens for messages. Read the documentation on our site for more information. | |
| 42 | +Powerful PHP Form Builder Class | |
| 43 | +WordPress Contact Forms utilizes a PHP form builder class to generate the forms, ensuring robust and efficient form creation and management. | |
| 44 | + | |
| 45 | +== Installation == | |
| 46 | +1. Upload `/contact-forms/` directory to the `/wp-content/plugins/` directory. | |
| 47 | +2. Activate the plugin through the 'Plugins' menu in WordPress. | |
| 48 | +3. Create one or more forms using the drag and drop interface. | |
| 49 | +4. Edit posts (or pages or custom types) and add the desired form using the "C" button in the visual editor (or using the shortcode. | |
| 50 | + | |
| 51 | +== Frequently Asked Questions == | |
| 52 | +You'll find the [FAQ on our website](http://www.cimatti.it/wordpress/contact-forms/faq/). | |
| 53 | + | |
| 54 | += Where do I report security bugs found in this plugin? = | |
| 55 | +Please report security bugs found in the source code of the | |
| 56 | +WordPress Contact Forms by Cimatti plugin through the [Patchstack | |
| 57 | +Vulnerability Disclosure Program](https://patchstack.com/database/vdp/contact-forms). The | |
| 58 | +Patchstack team will assist you with verification, CVE assignment, and | |
| 59 | +notify the developers of this plugin. | |
| 60 | + | |
| 61 | +== Screenshots == | |
| 62 | +1. Dashboard. Filter to show statisics from all forms or from individual forms. | |
| 63 | +2. Create forms easily with drag and drop. | |
| 64 | +3. Messages tab. Set up online success messages and email messages. | |
| 65 | +4. Preview tab. and test forms. | |
| 66 | +5. Choose styling options in Settings Page or in Preview tab. | |
| 67 | +6. Create your own fields for use in all forms. | |
| 68 | +7. List and manage forms. Edit, clone, see form submissions report, put in trash, copy shortcode or php code | |
| 69 | +8. Use screen options to show only the fields you need. Filter or search, then export. | |
| 70 | +9. Settings Page. Set up default options for all forms to avoid repetition. | |
| 71 | + | |
| 72 | +== Changelog == | |
| 73 | += 1.9.2 = | |
| 74 | +* Reverted an incorrect fix in the previous version | |
| 75 | + | |
| 76 | += 1.9.1 = | |
| 77 | +* Hardening for potential SQL injection vulnerabilities | |
| 78 | + | |
| 79 | += 1.9.0 = | |
| 80 | +* Checks for unfiltered_html capability and supports limited admin permissions in WordPress multisite configurations | |
| 81 | +* Filters the list of allowed upload file extensions according get_allowed_mime_types(), and check the maximum upload size with wp_max_upload_size() | |
| 82 | +* Default date fix | |
| 83 | +* Other minor fixes | |
| 84 | + | |
| 85 | += 1.8.0 = | |
| 86 | +* Using tinyColorPicker on frontend | |
| 87 | +* Fixed XSS vulnerability | |
| 88 | + | |
| 89 | += 1.7.0 = | |
| 90 | +* Lead status | |
| 91 | +* Minor fixes | |
| 92 | + | |
| 93 | += 1.6.1 = | |
| 94 | +* Fixed trashed form restore | |
| 95 | +* Fixed CSRF vulnerability | |
| 96 | + | |
| 97 | += 1.6.0 = | |
| 98 | +* IP masking option | |
| 99 | + | |
| 100 | += 1.5.10 = | |
| 101 | +* Fixed plugin icon | |
| 102 | + | |
| 103 | += 1.5.9 = | |
| 104 | +* Fixed adding more custom HTML fields and fieldsets | |
| 105 | + | |
| 106 | += 1.5.8 = | |
| 107 | +* Fixed CSRF vulnerabilities | |
| 108 | +* Fixed some JavaScript errors due to WordPress filters | |
| 109 | +* Fixed many minor bugs | |
| 110 | + | |
| 111 | += 1.5.7 = | |
| 112 | +* tested compatibility with WordPress 6.2.0 | |
| 113 | + | |
| 114 | += 1.5.6 = | |
| 115 | +* Fixed CSRF vulnerability | |
| 116 | + | |
| 117 | += 1.5.5 = | |
| 118 | +* Fixed XSS vulnerabilities | |
| 119 | + | |
| 120 | += 1.5.4 = | |
| 121 | +* Graphical changes to default messages | |
| 122 | +* Fixed some minor bugs | |
| 123 | + | |
| 124 | += 1.5.3 = | |
| 125 | +* Removed unused code | |
| 126 | +* Fixed some minor issues | |
| 127 | + | |
| 128 | += 1.5.2 = | |
| 129 | +* Fixed critical error when trying to access the dashboard | |
| 130 | + | |
| 131 | += 1.5.1 = | |
| 132 | +* Renewed UI | |
| 133 | +* Fixing some minor bugs | |
| 134 | + | |
| 135 | += 1.4.14 = | |
| 136 | +* Lazy load reCAPTCHA | |
| 137 | + | |
| 138 | += 1.4.13 = | |
| 139 | +* added html attributes to improve SEO | |
| 140 | + | |
| 141 | += 1.4.12 = | |
| 142 | +* Tested compatibility with PHP up to 8.0 and WordPress up to 5.8.1 | |
| 143 | +* reCAPTCHA loaded from recaptcha.net trying to improve accessibility from countries banning google.com domain | |
| 144 | +* Fixed minor XSS vulnerability reported on wpscan.com by Felipe Restrepo Rodriguez and Sebastian Cruz Cardona. Form title was not sanitized in every place it was used in the admin interface, however this is mitigated by the fact that only admin users with manage_options capability can edit it. | |
| 145 | + | |
| 146 | += 1.4.11 = | |
| 147 | +* avoid "headers already sent" warnings during WordPress cron | |
| 148 | + | |
| 149 | += 1.4.10 = | |
| 150 | +* Tested compatibility with PHP up to 7.4 | |
| 151 | +* After submission, the fragment #formSubmitSuccess-formID is added to the URL, so the page is scrolled to the top of the message, and it's easier to track the submission with tools like Google Analytics | |
| 152 | +* fragments #formSubmitInvalid-formID and #formSubmitError-formID are added in case of invalid submission or error | |
| 153 | +* improved loading of reCAPTCHA | |
| 154 | +* removed unused resources from PFBC library | |
| 155 | +* colorPicker styles and javascripts now loads only if it's used | |
| 156 | +* other small bugfixes | |
| 157 | + | |
| 158 | += 1.4.9 = | |
| 159 | +* improved compatibility with Google Tag Manager to track field filled in and form submission | |
| 160 | + | |
| 161 | += 1.4.8 = | |
| 162 | +* fixed compatibility issues with php 7.2 | |
| 163 | +* option to track field filled in and form submission as events on Google Analytics | |
| 164 | +* workaround to open/download attachments in submissions exported and opened with Microsoft Excel | |
| 165 | + | |
| 166 | += 1.4.7 = | |
| 167 | +* fixed compatibility issue with WordPress 4.8 that made show/hide buttons for field settings in the form editor invisible | |
| 168 | +* fixed compatibility issues with php 7.0 and 7.1 | |
| 169 | +* fixed strict standards errors | |
| 170 | + | |
| 171 | += 1.4.6 = | |
| 172 | +* restored compatibility with PHP < 5.3 | |
| 173 | +* fixed some strict standards errors | |
| 174 | + | |
| 175 | += 1.4.5 = | |
| 176 | +* Scaled reCAPTCHA 2 area for devices with less than 400px screen width | |
| 177 | +* More informations about senders and receivers of the form emails in the forms list page | |
| 178 | + | |
| 179 | += 1.4.4 = | |
| 180 | +* Changed text domain of translatable strings to match the plugin slug | |
| 181 | +* Bulk action to delete permanently trashed submissions | |
| 182 | + | |
| 183 | += 1.4.3 = | |
| 184 | +* Fixed table index length issue that prevented saving submission values of new user of Contact Forms with recent WordPress versions | |
| 185 | +* Added internationalization info | |
| 186 | + | |
| 187 | += 1.4.2 = | |
| 188 | +* Fixed table definition error that prevented saving submission of new users of Contact Forms 1.4.0 | |
| 189 | + | |
| 190 | += 1.4.1 = | |
| 191 | +* Fixed undefined variable in accua-form-api.php on line 29 | |
| 192 | + | |
| 193 | += 1.4.0 = | |
| 194 | +* Filter and export by year and month | |
| 195 | +* Added actions accua_forms_field_added, accua_forms_field_updated and accua_forms_field_deleted | |
| 196 | + | |
| 197 | += 1.3.9 = | |
| 198 | +* better support for reCAPTCHA allowing to enter site keys and use version 2 | |
| 199 | +* fixed visualization bug of reCAPTCHA 1 with new WordPress themes | |
| 200 | +* fixed bug that prevented editing fields on the page after a form submission | |
| 201 | + | |
| 202 | += 1.3.8 = | |
| 203 | +* fixed incompatibility with WordPress 4.4 that prevented submissions export | |
| 204 | + | |
| 205 | += 1.3.7 = | |
| 206 | +* fixed incompatibility with WordPress 4.4 that caused a PHP error in every page that includes a form | |
| 207 | +* new token for select, checkbox and radio labels | |
| 208 | +* changed database table to allow referrers and urls longer than 255 characters | |
| 209 | + | |
| 210 | += 1.3.6 = | |
| 211 | +* Replaced deprecated user level '10' with capability 'manage_options' | |
| 212 | + | |
| 213 | += 1.3.5 = | |
| 214 | +* fixed incompatibility of form editor with WordPress 4.3 and Chrome | |
| 215 | +* adding rules to robots.txt to allow /wp-admin/js/ and /wp-admin/css/ for styles and scripts included from that folders | |
| 216 | + | |
| 217 | += 1.3.4 = | |
| 218 | +* Password fields now saves the hash value of the password using wp_hash_password | |
| 219 | +* Field to set the emails "From:" name | |
| 220 | +* fixed CAPTCHA field incompatibility with CloudFlare RocketLoader and possibly other JavaScript optimizer | |
| 221 | +* fixed glitch in the "Form fields" area on the "Edit form" page with latest versions of WordPress | |
| 222 | + | |
| 223 | += 1.3.3 = | |
| 224 | +* improved checkboxes, select and radio definition to allow pre-selected options | |
| 225 | +* fixed PHP 5.5 incompatibility issue. Now the plugin works with PHP from version 5.2 to 5.5 | |
| 226 | +* fixed default value for email, colorpicker and password fields | |
| 227 | +* allowed removal of elements by a filter after the form generation | |
| 228 | + | |
| 229 | += 1.3.2 = | |
| 230 | +* fixed visualization of color picker field | |
| 231 | +* workaround to have multiple forms with recaptcha on the same page | |
| 232 | + | |
| 233 | += 1.3.1 = | |
| 234 | +* fixed validation of required fields with multiple values | |
| 235 | +* show recipient of admin email in form list | |
| 236 | +* changes in submissions list generation and export to allow usage by other plugins | |
| 237 | + | |
| 238 | += 1.3 = | |
| 239 | +* Spanish translation by Maria Ramos of [WebHostingHub](http://www.webhostinghub.com/) | |
| 240 | +* Color picker field | |
| 241 | +* Possibility to insert raw tokens in html messages | |
| 242 | +* Disabled HTML5 validation of email fields, using JavaScript validation | |
| 243 | + | |
| 244 | += 1.2.1 = | |
| 245 | +* Fixed installation and upgrade process issues introduced in 1.2 | |
| 246 | +* Users who installed 1.2 as their first version reported that submissions where not saved. Upgrading to this version will fix this issue | |
| 247 | + | |
| 248 | += 1.2 = | |
| 249 | +* Fieldsets | |
| 250 | +* Submissions trash and restore | |
| 251 | +* Fixed counting of active and deleted forms | |
| 252 | +* Fixed submission bug in Internet Explorer 8 and previous versions | |
| 253 | + | |
| 254 | += 1.1 = | |
| 255 | +* Added interface to set basic form styles (borders, colors, padding) | |
| 256 | +* Fixed captcha validation | |
| 257 | +* Added submission graph by form | |
| 258 | +* Screenshots removed from the package | |
| 259 | +* Other minor fixes | |
