This document is for an older version of
Freeform
.
View latest version →
Freeform for ExpressionEngine
1.x Retired
Changelog
2021-05-27
1.8.4Fixes
- Fixed a compatibility issue with AJAX and PHP 7.4.
2019-12-11
1.8.3Additions
- Added ability to duplicate forms.
Security
- Fixed a potential security vulnerability with submitting of forms.
2019-11-15
1.8.2Fixes
- Fixed a bug where the 'Automatically Scroll to Form on Errors and Multipage forms' setting was no longer working.
- Fixed a bug where data for Dynamic Recipients fields was not correctly displaying in the Submissions template tag and email notification templates.
- Fixed a bug where formatting Table field data in the Submissions template tag and email notifications was not possible.
- Fixed a bug where the 'token' parameter was not working for the Submissions template tag.
- Fixed a bug where some number field types were not showing up for the Salesforce API integration.
2019-09-18
1.8.1Fixes
- Fixed a bug where the Lite and Express editions were displaying errors in the control panel and forms were not submitting correctly on the front end.
2019-09-17
1.8.0Additions
- Added Table field type, which allows users to enter repeating data rows into predefined columns (Pro).
- Added ability to edit submissions on the front end (Pro).
- Added submission tokens, allowing you to more securely display (and edit) submission data in front end templates.
Fixes
- Fixed a bug where line returns in Textarea fields wouldn't show up correctly in front end templates.
2019-06-20
1.7.13Additions
- Added support for Bloqs add-on.
- Added basic Portuguese and French translations files.
Fixes
- Fixed a bug where Textarea fields were no longer properly parsing linebreaks in email notifications.
- Fixed a bug where hidden fields couldn't be searched upon in the Submissions CP page.
- Fixed a bug where fields with predefined options containing numeric values were excluded from email notifications.
- Fixed a bug where the Classic migration utility would choke on form names that started with a number.
- Fixed a bug where EE data feeders were not including data from all fields when using to populate Freeform multi-option fields.
- Fixed a bug where adding a sample template to Formatting Templates section would not work if you have a relative path set.
2019-04-25
1.7.12Changes
- Updated file upload field values in email notification templates to return as pipe-delimited IDs to accomodate usage with File:Entries tag.
2019-04-22
1.7.11Additions
- Added Insightly CRM Lead integration for Freeform Pro edition.
Security
- Fixed a potential XSS security vulnerability when displaying form submissions.
Fixes
- Fixed a bug where the Migration utility could sometimes error.
- Fixed a bug where the Freeform fieldtype would display errors in Live Preview if no form was assigned to the entry.
2019-03-19
1.7.10Fixes
- Fixed a bug where the CP submissions single detail view would error if a mailing list field was set to hidden.
2019-03-11
1.7.9Fixes
- Fixed a bug where setting the
maxlength
option for text and textarea fields to a value inside Composer, and then clearing the value, would result in the form rendering withmaxlength
of0
. - Fixed a bug where form rendering was automatically inserting in empty
maxlength
andplaceholder
attributes. - Fixed a bug where Freeform Permissions did not include controls for the Email Notifications section.
- Fixed a bug where checkboxes were not showing as checked in CP submission individual view.
- Fixed a bug where CP Submissions searching did not include field types like Hidden, Select, etc.
2019-01-30
1.7.8Fixes
- Fixed a bug where the 'Automatically Scroll to Form on Errors and Multipage forms?' setting was not working for multi-page form returns.
- Fixed a bug where the Freeform channel entry fieldtype could prematurely trigger submit logic in certain scenarios.
2019-01-21
1.7.7Additions
- Added 'Automatically Scroll to Form on Errors and Multipage forms?' setting to allow the ability to disable this feature.
Changes
- Updated Salesforce Lead integration to clear out all empty values before submitting to Salesforce.
Security
- Fixed a potential XSS vulnerability.
Fixes
- Fixed a bug where editing submission field layouts in Submissions CP list page were sometimes not working.
- Fixed a bug where the Submission CP list page could error if the form contained fields which had no values submitted previously.
2018-12-24
1.7.6Changes
- Updated Classic migration to maintain original submission dates of migrated submissions.
Fixes
- Fixed a bug where Classic migrations could stop working in rare cases.
2018-12-19
1.7.5Additions
- Added
field_id_prefix
parameter to the Freeform:Form and Render tags to set a prefix value on field output. Helpful if you have more than 1 form on the same template and are sharing fields.
Fixes
- Fixed a bug where having more than 1 form in the same template would cause one form to take over the other form if the page reloaded from errors being present.
- Fixed a bug where the JS autoscroll feature would act up if there was an error on a form and there was more than 1 form in the same page.
- Fixed a bug where using data feeders from EE Entries, etc in Freeform fields would significantly impact submit wait time for forms on front end.
- Fixed a bug where the US States predefined options list contained more than official states. Also added a States & Territories list that contains official states and territories.
- Fixed a bug where the CP submission list date filters were not including the selected end date range in results.
- Fixed a bug where the
use_action_url="yes"
parameter was not working correctly in Freeform:Form and Render tags. - Fixed a bug where the CP submission list filters were missing some translations.
2018-12-03
1.7.4Fixes
- Fixed a bug where submissions titles were not showing up correctly in some cases in CP Submissions list.
2018-11-30
1.7.3Fixes
- Fixed a bug where CP Forms list, Composer and front end forms render would error when using PHP 5.4 (EE3).
- Fixed a bug where rendering a form on front end would error in PHP versions below 7.x (EE3).
- Fixed a bug where extension hooks were not being uninstalled correctly.
- Fixed a bug where CP Submissions filters were not working correctly when using Session ID.
2018-11-21
1.7.2Additions
- Added
search:field="value"
parameter to Submissions template tag to allow filtering of results by field values.
Security
- Fixed a potential XSS vulnerability.
Fixes
- Fixed a bug where some parts of Freeform would error when using PHP 5.4 (EE3).
- Fixed a bug where editing an existing field's name in Field Editor would automatically rename the handle.
- Fixed a bug where the Field Editor was displaying an extra set of Default Value and Placeholder fields in settings.
2018-11-07
1.7.1Fixes
- Fixed a bug where default selections for multi-option fields populated with predefined and EE data were not respecting default option selections on front end.
- Fixed a bug where the Classic Migration would stall while migrating submissions if a form contained no submissions.
- Fixed a bug where Freeform was converting number strings to actual numbers when saving the form.
- Fixed a bug where 'reCAPTCHA' was available as a fieldtype choice (it's only available as a special field).
- Fixed a bug where the Dynamic Recipients fieldtype was parsing as
0
,1
etc instead of the option value. - Fixed a bug where Composer would error when using PHP 5.4 (EE3).
2018-11-01
1.7.0Additions
- Added field option Data Feeders for Checkbox group, Radio group, Select and Multi-select fieldtypes. You can now populate these fields with Entries, Categories, Members, or one of our many predefined options: States, Provinces, Countries, Languages, Number ranges, Year ranges, Months, Days and Days of the Week. Freeform Data Feeders also offer flexible control over formatting and/or which data fills option labels and option values.
- Added Multi-select fieldtype.
- Added filtering options in CP Submissions list view.
- Added reCAPTCHA support for Freeform Pro edition.
- Added dotmailer mailing list integration for Freeform Pro edition.
- Added Member Group Permissions controls - allow or deny access to various pages and parts of Freeform control panel.
- Added ability to render Dynamic Recipients as checkboxes, and now allows submitter to select more than 1 option.
- Added ability to set Mailing List fields as hidden fields (automatically opting in users).
- Added a variety of thorough AJAX examples to demo templates!
- Added support for mapping to website, URL, dropdown, radio, date and zip fields in MailChimp integration.
Changes
- Updated SharpSpring integration to work with all custom field types.
- Updated column breakpoint for Bootstrap formatting templates to be
sm
instead oflg
. - Updated Freeform's automatically inserted JS to no longer include
type="text/javascript"
.
Fixes
- Fixed a bug where Classic Migration wouldn't work correctly in some cases.
- Fixed a bug where the
{if field:has_errors}
conditional was not working. - Fixed a bug where an error would show if using PHP 7.2 with error debugging enabled.
- Fixed a bug where mapping to MailChimp fields named as numbers would result in an error.
- Fixed a bug where Freeform would error for PHP 5.4.
- Fixed minor visual errors throughout control panel.
2018-07-19
1.6.4Additions
- Added
date_created
variable for availability in email notification templates.
Changes
- Updated form validation to no longer allow a single space as a valid value for required fields.
- Updated HubSpot integration to load custom fields from Contacts, Companies and Deals endpoints now, not just Deals.
Fixes
- Fixed a bug where the Salesforce fetch token URL regex restriction was not allowing for less common URLs to pass through.
- Fixed a bug where the 'unfinalized_files' database table was not correctly removing rows when a multi-page form was successfully submitted, causing uploaded files to be removed.
- Fixed a bug where multi-page forms were losing track of field data for autogenerated titles in form submissions.
2018-05-17
1.6.3Additions
- Added
beforePush
andafterPush
developer hooks for API integrations. - Added
use_action_url="yes"
parameter to Form tag as a workaround when loading a form with AJAX and submitting normally.
Fixes
- Fixed a bug where the Salesforce fetch token URL regex restriction was not allowing for less common URLs to pass through.
- Fixed a bug where saving a channel entry with no Freeform form selected in the fieldtype would store a
0
instead ofNULL
. - Fixed a bug where viewing submissions in the CP with an upload field with missing files could result in an error shown.
- Fixed a bug where the 'Express' edition check was writing files to the add-on directory and not the cache directory.
- Fixed a bug where the hidden Spam honeypot field label was missing the 'for' attribute.
2018-04-25
1.6.2Security
- Fixed an XSS security vulnerability with submitting forms.
Fixes
- Fixed a bug where a 'Handle Missing' error would display incorrectly for Mailing List fields in Composer layout.
2018-04-04
1.6.1Changes
- Updated Constant Contact API integration to no longer use OAuth and fixed a bug with it not connecting correctly.
Fixes
- Fixed a bug where upgrading from Express edition to Lite/Pro edition would not install the Freeform fieldtype for channel entries.
2018-03-29
1.6.0Additions
- Added Pipedrive CRM integration for Freeform Pro edition.
- Added new settings for Salesforce CRM integration for assignment rules and accounts with custom URLs in Salesforce.
- Added a setting for spam protection that allows you to control the behavior of submit return (to simulate a successful submit).
- Added warnings in Composer to show if a field has a blank handle.
- Added Freeform fieldtype support for the Grid fieldtype.
- Added a {field:option_value} variable for multi-option field types in email notification templates (for accessing the field option value instead of option label).
- Added 'form_before_submit' and 'form_after_submit' extension hooks.
Fixes
- Fixed a bug where checkbox an radio group field type option labels were not translatable.
- Fixed a bug where the File Upload fieldtype was not fully compatible with PHP 5.4.
- Fixed a bug where Freeform might conflict with other add-ons.
- Fixed a bug where the Edit Layout modal in CP Submissions list page was not loading correctly.
2018-03-07
1.5.2Changes
- Updated multi-page limit in Composer to 100 pages.
Fixes
- Fixed a bug where Radio Group fields would have their last option selected no matter what, when using sample formatting templates.
- Fixed a bug where Select fields would not send data in email notifications.
2018-02-27
1.5.1Changes
- Updated File Upload fields to have the ability to accept multiple files.
- Updated Classic migration utility to migrate File Upload fields with multiple files correctly now.
- Updated Dynamic Recipients field to have the ability to accept multiple recipients.
- Updated demo templates and default formatting templates to correctly handle Dynamic Recipients field as a radio group.
- Updated Checkbox fieldtype to show a warning in Composer when no value is set.
Fixes
- Fixed a bug where using Dynamic Recipients fieldtype as Radio display would not send email notifications.
- Fixed a bug where multi-option field types had ID attributes that were not unique for each option by default.
2018-02-09
1.5.0Additions
- Added Migration utility (beta) for migrating Freeform Classic data.
- Added a 'Use Double Opt-in?' setting for MailChimp integrations.
Changes
- Included an update that adjusts database key lengths of fields for compatibility with
utf8mb4
character set in EE4.
Fixes
- Fixed a bug where Dynamic Recipients notifications sometimes would not work correctly.
- Fixed a bug where the default value and placeholder attributes were not applied to Website fields when added to form in Composer.
- Fixed a bug where deleting fields was not removing them from forms.
2018-01-09
1.4.2Additions
- Added setting to remove newlines from textarea fields for exporting.
Fixes
- Fixed a visual bug for right column buttons in Composer interface for EE3.
2017-12-21
1.4.1Additions
- Added Fluid fieldtype compatibility for the Freeform channel entry fieldtype.
Changes
- Updated Salesforce integration to work with checkbox fields.
Fixes
- Fixed some visual bugs in Composer interface between EE3 and EE4 versions.
- Fixed a bug where creating new fields with options would not save any default selections.
- Fixed a bug where the toggle switch was not displaying correctly for allowing values for fieldtypes with options in EE4.
2017-12-20
1.4.0Additions
- Added 'Express' edition of Freeform, which is a lower cost option for smaller/simpler sites.
Changes
- Improved Composer interface to have sticky/locking auto-scrolling side columns. This makes searching through available fields and working with longer forms easier.
2017-12-18
1.3.2Fixes
- Fixed a bug where Freeform would not install due to a 'max key length' error for some customers on EE4.
- Fixed a bug where the Spam protection feature's "count" in control panel was incrementing incorrectly with each successful submission.
2017-12-12
1.3.1Changes
- Updated the auto-scroll for error return handling to be more reliable.
Fixes
- Fixed a bug where Freeform would not install and error for some customers on EE4.
- Fixed a bug where CP pages were not being styled correctly in EE4.
- Fixed a bug where Freeform was not translatable with language files.
2017-12-04
1.3.0Changes
- Updated for compatibility with both ExpressionEngine 4 and ExpressionEngine 3.
- Renamed Freeform Next and Freeform Next Pro to just Freeform Lite and Freeform Pro, respectively. Folder and namespace are still 'freeform_next' to preserve legacy with Freeform Classic.
Fixes
- Fixed a bug where the automated handle generator JS would make you wrestle with it sometimes.
- Fixed a bug where Composer would choke on form handles and field handles that contained
true
orfalse
strings in them.
2017-11-10
1.2.2Additions
- Added Max Length option to be set inside Composer for Text and Textarea fields.
Changes
- Updated CP views to be compatible with ExpressionEngine 4.
- Updated Date & Time field to no longer switch to being handled by browser in Mobile view due to chances of incorrect formatting.
Fixes
- Fixed a bug where the Dynamic Recipients field would not remember which selection was chosen if the page reloaded after triggering an error.
- Fixed a bug where the Date & Time field date picker was not working correctly for IE 11.
- Fixed a bug where the 'instructions_below_field' parameter was not correctly accepting 'yes' and 'no'.
2017-11-01
1.2.1Fixes
- Fixed a bug where Pro fieldtype fields would not show as options for mapping to API integrations.
- Fixed a bug where the SharpSpring integration would error in some cases.
- Fixed a bug where editing a field in main fields area (Freeform -> Fields) would error on the fieldtype selection.
2017-10-26
1.2.0Additions
- Added new SharpSpring CRM API integration for Pro version.
- Added auto-disable Submit button feature once a user clicks Submit (and a setting for it in control panel).
Changes
- Updated
form_attributes
parameter to allow no attribute value (to achievenovalidate=
instead ofnovalidate="true"
, etc). - Updated form submissions in Submissions list of control panel to be ordered by newest date first as default.
Fixes
- Fixed a bug where Freeform was allowing double (or more) submitting of forms if users kept clicking the Submit button while it was loading.
- Fixed a bug where instruction text would overlap the "remove" link (if long enough) for single Checkbox fields in Composer interface.
2017-10-18
1.1.2Fixes
- Fixed a bug where single Checkbox fields would not remember their selection if the form errored or if the submitter went back a page in multi-page forms.
- Fixed a bug where fields with array data would display as a literal array when exporting in CSV.
- Fixed a bug where an array of data in select fields for Salesforce API integration could cause an error.
2017-10-06
1.1.1Fixes
- Fixed a bug where fresh installs would error after install.
- Fixed a bug where some field specific property variables were unavailable for parsing on front end in manual implementations.
2017-10-03
1.1.0Additions
- Added new Field types for Pro version: Confirmation, Date & Time, Number, Phone, Rating, Regex, Website.
- Added advanced Quick Export and Export Profiles options in Pro version.
- Added a setting to hide Solspace default formatting templates from showing in Formatting Template dropdown list in Composer.
- Added an example formatting template and demo template for Materialize framework.
- Added form anchor to be automatically generated so inline error returns can focus down to form, if it's lower down on page.
Changes
- Updated Freeform to use EE's Email service instead of its own.
Fixes
- Fixed a bug where
{field:checked}
variable was not working for manual implementations of checkbox fields. - Fixed a bug where date_range_start/end="" and date_range="" parameters were not working in Submissions template tag.
- Fixed a bug where status filtering would result in an error in the Submissions template tag.
- Fixed a bug where no errors would be triggered if attempting to create a blank field (no name or handle, etc).
2017-09-18
1.0.7Fixes
- Fixed a bug where creating a new File Upload field (Fields area) would trigger an error if a value isn't specified for Maximum Filesize.
- Fixed a bug where single Checkbox fields would always return the default value for the field in Submissions tag and email notifications, whether or not the checkbox is checked.
- Fixed a bug where quick creating fields, email templates and formatting templates in Composer would not autoload them into the list.
2017-08-28
1.0.6Changes
- Updated Composer to show hash handles for Submit and HTML blocks so they can be accessible manually in frontend templates.
- Updated textareas to now automatically convert newlines to line breaks when outputting data in templates or email notifications.
Fixes
- Fixed a bug where selected values for fields with options would not output correctly.
- Fixed a bug where tabbing through labels and values in Field creation/editing area would reset values.
- Fixed a bug where the honeypot field for spam protection did not have spaces in-between attributes.
- Fixed a bug where Composer would have JS errors when creating new fields while using Sessions only in CP.
2017-07-25
1.0.5Fixes
- Fixed a bug where 1.0.4 upgrade would show errors in CP for some installs.
2017-07-25
1.0.4Additions
- Added a Sandbox option for Salesforce integration in Pro version.
- Added option to use database instead of PHP sessions for storing state of form submissions.
Fixes
- Fixed a bug where forms would not submit correctly for some users.
- Fixed a bug where single checkbox fields were not saving the user's selection if errors were triggered.
- Fixed a bug where single checkboxes were not displaying the field value in email notifications.
- Fixed a bug where email validation was allowing some invalid syntax.
- Fixed a bug where the Update Service would error if it couldn't connect to Solspace.com.
- Fixed a bug where the Mailer extension hooks were not working correctly.
2017-07-03
1.0.3Fixes
- Fixed a bug where Freeform Updates Service was writing to add-on folder instead of EE Cache directory.
- Fixed a bug where unchecking ALL filetype options for File Upload fields in Fields area would not save preferences.
- Fixed a bug where {field_name} syntax would NOT parse in Subject/From Name/From Email/Reply-to fields when not Storing Submissions in DB.
- Fixed a bug where an error might display when viewing submissions list in the CP in some circumstances.
- Fixed a bug with MailChimp integration where it would only load a maximum of 10 MailChimp custom fields.
- Fixed a bug where orphaned mailing list setups would error in Composer.
2017-06-06
1.0.2Fixes
- Fixed a bug where Composer would error and show a blank white page in some cases.
- Fixed a bug where Mailing List and CRM pages would sometimes display an error.
- Fixed a bug where the version number update process wouldn't work correctly.
2017-06-05
1.0.1Fixes
- Fixed a bug where Freeform Next would not install on sites using MySQL 5.5 and lower.
- Fixed a bug where new statuses could not be created.
- Fixed a bug where some sites might see an error when attempting to create new fields.
2017-06-01
1.0.0WARNING
There is currently no migration path from classic Freeform/Freeform Pro to Freeform Next.
Additions
- Initial release.