Freeform3.1.4
Compatible with: EE1 / EE2
Description
Freeform allows you to create simple and flexible forms on your site to collect information from your users. Postings to your forms are recorded and organized in your EE database as well as optionally mailed to the notification emails you supply. You can receive attachments from submitters and have those attachments stored in your database as well as mailed back out as attachments to admins or the submitting user.
Shortcut link to this page:
Compare
Link to this page:
Changelog
- 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.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.
Installation
ExpressionEngine 2.x Installation Instructions
1. Copy Add-on Files
- Within the /EE2/system/expressionengine/third_party/ directory, copy the freeform folder into your sites’ ./system/expressionengine/third_party/ directory.
2. Installing the Add-On
- Go to the Modules area in the ExpressionEngine Control Panel, find Freeform in the list, and click Install.
3. Setup & Configuring
- Nothing is actually required to configure Freeform. However, Freeform does have a handful of additional features available that require configuration for usage.
- To adjust any settings in Freeform, click on the Preferences tab in the Control Panel area and then modify as necessary.
4. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
ExpressionEngine 1.x Installation Instructions
1. Copy Add-on Files
This add-on requires that you use the Solspace Bridge software with ExpressionEngine 1.x. It will be included with your download in a separate folder.
- Within the /EE1/system/ directory, copy the bridge folder into your sites’ ./system/ directory.
- Within the /EE1/system/modules/ directory, copy the freeform folder into your sites’ ./system/modules/ directory.
2. Installing the Add-On
- Go to the Modules tab in the ExpressionEngine Control Panel, find Freeform in the list, and click Install.
3. Setup & Configuring
- Nothing is actually required to configure Freeform. However, Freeform does have a handful of additional features available that require configuration for usage.
- To adjust any settings in Freeform, click on the Preferences tab in the Control Panel area and then modify as necessary.
4. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
Updates
After downloading the latest version of the add-on, unzip the download file and follow these instructions...
ExpressionEngine 2.x Updating Instructions
1. Copy Add-on Files
- Within the /EE2/system/expressionengine/third_party/ directory, copy the freeform folder into your sites' ./system/expressionengine/third_party/ directory.
2. Updating the Add-On
- Go to the Modules area in the ExpressionEngine Control Panel and click the link for Freeform
- Click the Update link now displayed in the module's control panel.
3. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
ExpressionEngine 1.x Updating Instructions
1. Copy Add-on Files
This add-on requires that you use the Solspace Bridge software with ExpressionEngine 1.x. It is included with your download in a separate folder.
- Within the /EE1/system/ directory, copy the bridge folder into your sites' ./system/ directory.
- Within the /EE1/system/modules/ directory, copy the freeform folder into your sites' ./system/modules/ directory.
2. Updating the Add-On
- Go to the Modules tab in the ExpressionEngine Control Panel and click the link for Freeform
- Click the Update link now displayed in the module's control panel.
3. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
Software Support
We pride ourselves on our level of support and our attention to the customer. If you have an issue, we're here to help.
30-day Money Back Guarantee
If your software purchase does not meet your expectations, or is not right for you, just let us know and we'll give you a full refund within 30 days of purchase.


