Freeform 3.x
Legacy documentation for Freeform 3.x.
- Version 3.1.5
- Version 3.1.4
- Version 3.1.3
- Version 3.1.2
- Version 3.1.1
- Version 3.1.0
- Version 3.0.6
- Version 3.0.5
- Version 3.0.4
- Version 3.0.3
- Version 3.0.2
- Version 3.0.1
- Version 3.0.0
- Version 2.7.2 - Build 20090721
- Version 2.7.2
- Version 2.7.1 - Build 20090218
- Version 2.7.1 - Build 20090111
- Version 2.7.1 - Build 20090108
- Version 2.7.1
- Version 2.7.0 - Build 20081211
- Version 2.7.0
- Version 2.6.6
- Version 2.6.5
- Version 2.6.4
- Version 2.6.3 - Build 20080222
- Version 2.6.3
- Version 2.6.2
- Version 2.6.1
- Version 2.5.9
- Version 2.5.8
- Version 2.5.7
- Version 2.5.6
- Version 2.5.5
- Version 2.5.4
- Version 2.5.3
- Version 2.5.2
- Version 2.5.0
Version 3.1.5 (January 25, 2013)
- Fixed a bug when editing then saving entries from the CP with the 'show_empties' checkbox checked.
- Fixed a bug where MySQL errors would occur in EE 2.5.4+.
- Fixed a bug where Freeform would show an error on form submission if the IP to Nation module was not installed.
Version 3.1.4 (May 10, 2012)
- Added entry_id to the JSON array that can be outputted upon successful submission.
- Fixed a bug where file upload errors did not display the error language properly to the end user.
- Fixed a bug where parameters would expire and still allow form submission when Secure Form Hashes was disabled.
- Fixed a bug where PHP 5.4 with E_STRICT would throw an error.
- Fixed a bug where in EE1, with Secure Forms disabled, an error would show up when editing a Freeform entry in the CP.
- Fixed a bug where empty fields would not show up when editing an entry in the CP if the status was closed.
- Fixed a bug where changing an existing field name with an already existing field name value would cause a MySQL error on submit.
Version 3.1.3 (February 13, 2012)
- Added the output_json="yes" parameter, which can be used with AJAX requests to return errors and success mesages in JSON. Default is 'no'.
Version 3.1.2 (February 10, 2012)
- Added option to select which fields are visible in the Entries tab of the Freeform control panel (EE2-only).
- Added compatibilty for MySQL Strict.
- Modified Freeform to support AJAX requests by default. To disable, use ajax_request="no" parameter on Freeform:Form.
- Fixed a potential XSS security issue in the MCP.
- Fixed a bug where forms were given an incorrect name attribute value when the form:name= parameter wasn't specified in Freeform:Form tag.
- Fixed a bug where the max_file preference was being calculated incorrectly.
- Fixed a bug where when exporting to CSV, entries with commas or quotes were not properly escaped.
- Fixed a bug where file uploads in forms submissions were being validated too late.
Version 3.1.1 (November 4, 2011)
- Fixed a bug where the entry_id parameter was being ignored in the Freeform:Entries tag.
- Fixed a bug where Freeform was adding "http://" to URL's submitted into custom fields.
- Fixed a bug where passing an array input and requiring the field would trigger a PHP error.
- Fixed a bug where using quotes in a Freeform field name label would not work correctly.
Version 3.1.0 (June 21, 2011)
- Converted Freeform to use Solspace Add-on Builder Framework, and Solspace Bridge for EE 1.x.
- Added compatibility for NSM addon updater.
- Added the ability to dynamically assign a "reply_to" value for admin notifications.
- Added 'allowed_file_types' parameter to Freeform:Form tag to allow additional validation of uploaded file types.
- Fixed a bug where the {collection_name} variable didn't parse in message area of notification templates.
- Fixed a bug where pagination in the CP was loosing some filter options.
Version 3.0.6 (February 3, 2011)
- Updated and enhanced Freeform module CP area (in EE 2.x) to conform completely to native EE styling.
- Fixed a bug where file extensions where getting cut off of file uploads in EE 1.x.
- Fixed a bug where default Prefs were not correctly cached and caused errors on the front end.
- Fixed a bug where Template Label, From Name, and Email Subject in the Notification Template create/edit CP area could cause errors when containing quotes or other special or non-latin UTF-8 characters.
- Fixed a bug where when a required field contains a value of "0" it wouldn't pass validation.
- Fixed a bug where the default 'website' field did not contain any security on it.
Version 3.0.5 (November 29, 2010)
- Added CSV export option in the Freeform CP.
- Fixed a bug where the Collection name was not being properly recorded to the database.
Version 3.0.4 (November 23, 2010)
- Fixed a bug where the {collection_name} variable was not parsing in the Freeform:Entries tag.
- Fixed a bug where the ID field was being inserted into hidden fields and conflicted with Ajax when used on a form.
- Fixed a bug where the "select all" checkboxes feature in the Freeform CP area would not work.
- Fixed a bug where having "subject" as a field name would cause issues.
- Fixed a bug where the uploaded files would display to have a file size of "1KB" in the Freeform CP.
- Fixed a bug where Freeform Preferences were not always stored properly in the database.
- Removed "flow_ui" theme from Freeform module in EE 1.x.
Version 3.0.3 (August 18, 2010)
- Modified Freeform to now use the native EE 2.x JS success/error messages.
- Fixed a bug where the confirmation link in the Mailing List opt-in email notification triggered by Freeform was not being parsed.
- Fixed a bug where Freeform was taking away the file extensions of uploaded files, or in some cases renaming them improperly.
- Fixed a bug where date formatting was not working on the entry_date variable when used in a "user" notification email.
- Fixed a bug where Freeform was improperly displaying foreign characters as entities in the Entry Editing area of the Freeform module CP.
- Fixed a bug where other EE tags would not parse properly inside Freeform template tags.
- Fixed a bug where when creating a custom Freeform field in the Freeform CP would throw an error if "Process form data in secure mode" is disabled.
Version 3.0.2 (July 12, 2010)
- Modified all instances of BASEPATH to now use PATH_THIRD as the app folder is outside of the system folder in EE 2.1.
Version 3.0.1 (June 15, 2010)
- Updated all instances of XID_SECURE_HASH to $XID_SECURE_HASH in EE 2.x view files.
- Fixed a bug where an error would display in the CP if you have no Freeform fields.
- Fixed a bug where the final extension hook call in insert_new_entry was improperly cleared.
- Fixed a bug where duplicate checking and conditionals were not working correctly for Super Admins.
Version 3.0.0 (May 13, 2010)
- Added the new Dynamic Recipients feature to Freeform:Form. Allows you to predefine a list of recipients for a user to choose from.
- Added several new parameters, form fields, variables, and variable pair to assist with the Dynamic Recipients feature.
- Added Tell-A-Friend functionality to Freeform:Form. Users can now enter in recipient email address(es).
- Added spam controls for the Tell-A-Friend functionality via the new Preferences tab in the CP and/or new parameters for Freeform:Form.
- Added the form:attribute="" parameter type to the Freeform:Form tag.
- Upgraded module to use Solspace Bridge 1.0 with CodeIgniter, therefore allowing compatibility with EE 2.x.
- Modified Freeform module to be PHP 5.3 compatible without throwing deprecated errors.
- Renamed all references to "form_name" to "collection". Deprecated "form_name" parameter.
- Fixed a bug where the {entry_date format=""} variable was not being correctly parsed in the User Notification email.
- Fixed a bug where if a Freeform field didn't exist and was added to the required="" parameter in Freeform:Form, it would return a PHP error.
- Overhauled and enhanced online Documentation.
Version 2.7.2 - Build 20090721 (July 21, 2009)
- Added a default $msg variable prior to the user email, in case it is not sent so that the extension hook does not throw an unset variable error.
- Fixed a bug where PHP errors would be outputted with mailing_list_opt_in="no" because of a variable collision.
Version 2.7.2 (May 8, 2009)
- Fixed a bug where the mailing_list_opt_in="no" parameter would not send the Admin Notification for the Mailing List module.
- Fixed a bug where upon File Upload error one could not resubmit because of the CAPTCHA no longer being valid.
Version 2.7.1 - Build 20090218 (February 18, 2009)
- Added the {freeform_entry_id} variable parsing to the Subject field for notification templates.
- Modified the File Size display for attachment size in the CP to display in KBs.
- Fixed a bug with redirect_on_duplicate="" parameter where forward slashes were converted to entities incorrectly in the hidden field.
Version 2.7.1 - Build 20090111 (January 11, 2009)
- Added {freeform_entry_id} to the list of available variables for Notification Templates.
Version 2.7.1 - Build 20090108 (January 8, 2009)
- Added "freeform_module_admin_notification" extension hook which allows you to alter the $msg variable before an admin notification is sent.
- Added "freeform_module_user_notification" extension hook which allows you to alter the $msg variable before a user notification is sent.
Version 2.7.1 (January 3, 2009)
- Added indexes to various tables in database to improve performance.
Version 2.7.0 - Build 20081211 (December 11, 2008)
- Fixed a bug where mailing list subscriptions would not work when sending the list_name in an array of values (ex: form checkboxes).
Version 2.7.0 (December 5, 2008)
- Added {freeform_entry_id} as a variable in the Notification templates.
- Added support for the format="" parameter for {entry_date} variable in the Freeform notification templates.
- Added secure_action="" and secure_return="" parameters to the Freeform:Form function.
- Added a default name="" attribute to the Freeform:Form function so that entries in the CP would always have a form name instead of a blank.
- Added a some descriptions to Template area in Freeform CP for clarity.
- Modified the form creation code to remove the action="" parameter, which was causing IE6 to behave incorrectly when an error message was shown.
- Modified the Templates section of the Freeform CP to show the available variables when creating a new template.
- Modified the mailinglist="" parameter to have Div's around hidden field for XHTML validation.
- Fixed a bug where the Manage Entries section of the CP that would use up all available PHP memory if excessive entries existed.
- Fixed a bug where the return="" parameter's forward slash HTML entity was not converted to a character.
- Fixed a bug where the {mailing_list} variable was not being parsed in the email activation template.
- Fixed a bug where when a Freeform Form was put on a Site's main index template, the redirect caused an error.
- Fixed a bug where Freeform was converting characters and entities on outputted forms, which caused problems with quotes and validation.
- Fixed a bug where duplicate emails could be inserted using the mailinglist="" parameter because the email could be inserted into the authorization queue multiple times.
- Fixed a bug where certain MySQL keywords were unable to be Freeform fields.
- Fixed a bug where Freeform was lowercased in the CP URLs, causing certain MySQL Strict servers not to show the module's CP at all.
- Fixed a bug in the Freeform:Entries function where the No Results conditional would not work.
- Fixed a bug where Freeform entries could be submitted with no form_name="" attribute with the Freeform:Form function.
- Fixed a bug where selecting no entries and trying to delete in the Freeform CP resulted in an error.
- Fixed a bug where using Sessions on front end would cause Session to show twice in return path.
Version 2.6.6 (August 14, 2008)
- Fixed various extension hook bugs.
Version 2.6.5 (March 27, 2008)
- Fixed "cannot yet handle MBCS in html_entity_decode" bug when using extension hooks.
Version 2.6.4 (March 19, 2008)
- Fixed stripped quotes bug.
Version 2.6.3 - Build 20080222 (February 22, 2008)
- Fixed return parameter slash bug.
Version 2.6.3 (February 14, 2008)
- Fixed entity decoding bug.
Version 2.6.2 (February 5, 2008)
- Fixed variable bugs in 'freeform_module_insert_end' extension hook.
Version 2.6.1 (January 8, 2008)
- Fixed return parameter slash bug w/ EE 1.6.1.
Version 2.5.9 (November 21, 2007)
- Corrected form validation bug related to params DB table deletions.
- Corrected bug caused by 1.6.1 REGEX change to adjust ampersands and slashes.
Version 2.5.8 (November 11, 2007)
- Fixed return param bug.
Version 2.5.7 (September 5, 2007)
- Fix status bug.
Version 2.5.6 (August 31, 2007)
- Fixed bug in entries tag.
Version 2.5.5 (August 27, 2007)
- Changed the name attribute on the form so that it is now set through the 'name' parameter rather than through 'form_name' for XHTML Strict compliance.
Version 2.5.4 (August 15, 2007)
- Added single entry capability in freeform:entries.
- Adopted new commenting syntax.
Version 2.5.3 (July 22, 2007)
- Added extension hooks.
Version 2.5.2 (May 16, 2007)
- Added entry id return capability.
Version 2.5.0 (April 15, 2007)
- Added file upload and attachment capability.
- Added attachment management functions to CP.
- Added html capability to notifications.
- Added file_upload parameter.
- Added form fields for multiple files of format name="file1".
- Added send_user_attachment parameter to form function.
- Added send_attachment parameter to form function.
- Added variables to email templates to add links to attachments in messages.
- Added attachment parsing to freeform:entries function.
- Added form_class param to exp:freeform:form.
- Added form_title param to exp:freeform:form.
- Updated method for passing form parameters and settings more securely to prevent hacking and other silliness.