Changelog

4.0.8 - 2022-11-21

Changed

  • Refactored the submission delete process to use batching.

Fixed

  • Fixed a bug where links to view/edit individual submissions in the CP disappeared in Craft 4.3.2+.
  • Fixed a bug where the Freeform Form element field type was not sorting form options alphabetically.
  • Fixed a bug where email notifications were sometimes not being fetched when fetched by handle.
  • Fixed a bug where two sets of "set status" actions would appear in CP submissions index.
  • Fixed a bug where fetching existing tags for the ActiveCampaign integration was not working correctly.

4.0.7 - 2022-10-25

Added

  • Verified compatibility with Craft 4.3.

Fixed

  • Fixed a bug where database notification templates were not being loaded properly in the form builder.
  • Fixed a bug where a warning was output in the Craft logs when loading dashboard widgets.
  • Fixed a bug where the "All Submissions" filter in Submissions and Spam Folder CP indexes would crash when there were more than 60 forms present.

4.0.6 - 2022-10-12

Added

  • Added a "Floating Labels" version of the Bootstrap 5 example formatting template.

Fixed

  • Fixed a bug where garbage collection was not working on Freeform submissions.
  • Fixed a bug where the "Send Additional Notification" feature was not working correctly.
  • Fixed a bug where searching freeform.submissions across multiple forms was not working correctly.

4.0.5 - 2022-10-05

Added

  • Added success events for AJAX forms with redirect-to-url behavior.

Fixed

  • Fixed a bug that would prevent some integrations with OAuth 2.0 from being able to authorize.
  • Fixed a bug where the Email Template dropdown select in the form builder would not show all templates if using a mix of database and file templates.
  • Fixed a bug where users could create file-based email notification templates in the form builder when the setting for it is disabled.
  • Fixed a bug where using the back button in multi-page forms could potentially cause issues when using default browser validation.

4.0.4 - 2022-09-28

Added

  • Added a setting to disable the creating and editing of File-based email notification templates.

Changed

  • Updated the AJAX response payload to include posted values.

Fixed

  • Fixed a bug where attempting to create a new status would not work.
  • Fixed a bug where some field types would not correctly store updates with empty values in multi-page forms.
  • Fixed a bug where users without permissions to Freeform could add Freeform widgets to the Craft dashboard.
  • Fixed a bug where the form reserved keyword was being allowed for field handles.

4.0.3 - 2022-09-12

Changed

  • Updated the Google Tag Manager event to include the AJAX response.

Fixed

  • Fixed a race condition issue where loading values when editing an element would sometimes not work.
  • Fixed a bug where duplicating forms could cause an error when more than one user group has permission to manage it.
  • Fixed a bug where the Tailwind 3 sample formatting template was not including custom input attributes when rendering Select fields.

4.0.2 - 2022-08-24

Fixed

  • Fixed a bug where non-latin characters were being allowed in field handles in the field manager area.
  • Fixed a bug where predefined assets in email notifications showed a full file path instead of just the filename.
  • Fixed a bug where multiple instances of the same form are added when moving the form instance around the DOM.

4.0.1 - 2022-08-23

Added

  • Added a v3 version of the Tailwind example formatting template.
  • Added a new version of the HubSpot API integration to address new Private App token requirement. This is a required change for any existing HubSpot users.

Changed

  • Updated the Campaign third party plugin email marketing integration to use new FormsService::createAndSubscribeContact method.

Fixed

  • Fixed a bug where attempting to sort submissions in the CP submissions index page was not working.
  • Fixed a bug where non-latin characters were being allowed in field and form handles.
  • Fixed a bug where attempting to view a related Freeform submission element in the slideout in another element could error.
  • Fixed a bug where attempting to attach a Predefined Asset to an email notification template would give an Internal server error.

4.0.0 - 2022-08-05

WARNING

This is a larger and more complex update than usual, and there's a higher chance of a failed update attempt happening. Please ensure you have a recent database backup, and we recommend you test the update on a local/staging environment before updating your production server. Please follow the Upgrading from Freeform 3.x guide.

Added

  • Added compatibility with Craft 4.x.
  • Added Export Email Notifications feature. Allows you to send exports as email notifications automatically.
  • Added more information to email notification error logging. It now includes the email notification approach and the Email field name (if applicable) to track down where the issue is coming from.
  • Added setting to have CSV exports use field handles for headings instead of field labels.
  • Added support for permanently deleting soft-deleted submissions.
  • Added data-skip-html-reload form attribute option to bypass HTML reload for AJAX forms (when not using render method).
  • Added EVENT_GET_CUSTOM_PROPERTY developer event, which lets you inject your own properties on forms to expand their application.
  • Added EVENT_CONFIGURE_CORS developer event, which lets you modify the CORS headers that will be sent with the request.
  • Added a check in the diagnostics, install welcome screen, and settings pages to alert users if the "Freeform Script Insert Type" setting will not work as Static URLs (and needs to be switched to Files).
  • Added the ability to map Mailchimp Interests to a form field. Limited to finding and passing a single Interest based on first match within Interest names part of a List.
  • Added support for date fields in the Campaign Monitor integration.

Changed

  • Changed all existing forms with the Success Behavior setting set to No Effect to now be Reload Form with Success Message. This will behave somewhat similarly to old behavior, but will no longer automatically redirect to a different URL upon success. Please review all forms and set the desired behavior for each in the Success Behavior setting. If you wish to continue to override the behavior at template level, you can do that as well.
  • Changed all sample formatting templates to include a library version number on them and also end with the .twig extension (e.g. foundation.html is now foundation-6.twig). Freeform 4 will automatically migrate all existing forms using sample formatting templates to use the new file names. You shouldn't need to change anything. Where this might become an issue is if you are using the formattingTemplate: 'template-name.html' parameter at template level and relying on an older version of the sample template name.
  • Changed all sample formatting templates use |t('freeform') only (instead of a mix of |t and |t('freeform')). If you're using static translations on sample formatting templates, you'll need to move site.php translations over to freeform.php.
  • Changed the rendering of single checkboxes to now use the value set inside the form builder. No action should be necessary here. If you have a custom module in place to override this behavior, you can likely undo that now.
  • Changed Email fields to no longer store data as an array. The migration will comb through your database and convert all values of Email field types (e.g. ["test@x.x"] will become test@x.x). If you were relying on this feature to collect more than one email address, only the first email address will be kept (e.g. ["a@x.x","b@x.x"] will become a@x.x). No action is necessary here, but if you relied on this functionality, it is a breaking change with no alternative option currently (aside from adding multiple Email fields to your forms, one for each email address). If you have a custom module that is working around this in any way, you should be able to disable it now.
  • Updated newly created email notification templates' "From" email address and name to default to the newer way (via Project Config), e.g. craft.app.projectConfig.get('email.fromEmail')). If you are using the older approach in existing email notification templates, be sure to update them.
  • Changed the way form submission data is stored. A new table for each form is now created and updated rather than storing all forms' submission data in a single shared database table. This solves several issues, including running out of fields and paves the way for more exciting future improvements to the form builder. Fields are still global and available to every form. No action should be necessary by the admin, as Freeform includes a migration script that automatically converts the data to be split into multiple database tables. This process may take a little longer if you have a very large site.
  • All Freeform fields are now stored as the TEXT MySQL type instead of a combination of TEXT, VARCHAR(100) and VARCHAR(255). This is a change that is applied to all existing fields as well since they are recreated in the migration. No action should be necessary here. In the rare case where your site has some kind of customization that relies on a MySQL type other than TEXT, you may have to adjust the database manually.
  • Updated Dashboard, Forms listing and Survey & Polls dashboard to hide forms for users that do not have any form or submission access permissions to them.
  • Switched over CP scripts to use local copies of external scripts.
  • Upgraded the GraphQL interface calls to use the new Craft GraphQL API.
  • Updated the "Use Return URL" success behavior to skip reloading the form (briefly) when using AJAX.
  • Updated the sample formatting templates to include ff-fieldtype-FIELDTYPE classes to field-surrounding divs.
  • Updated league/flysystem, symfony/property-access, symfony/finder and symfony/filesystem dependency version requirements to resolve some conflicts.

Fixed

  • Fixed a bug where POST Forwarding would still send through spammy submissions.
  • Fixed a bug where the form builder tutorial would show an error if the allowAdminChanges setting was disabled.
  • Fixed a bug where Drag & Drop File Upload fields would not respect all site URL setups.
  • Fixed a bug where users with permissions to Create New Forms would encounter issues in the New Form wizard modal.
  • Fixed a bug where users without Create New Forms permission would see the New Form button in the CP Forms page.
  • Fixed a bug where Number fields with a minimum value above 0 would still allow 0 as a valid value.
  • Fixed a bug where an error could sometimes occur on the Form Behavior settings page.
  • Fixed a bug with conditional Post Forwarding options check.
  • Fixed a bug where the Drag & Drop File Upload field type was requiring a file to be selected even when hidden by the Conditional Rules feature.
  • Fixed a bug where the predefined "Yesterday" option for Export Profiles returned yesterday 0:00 until now instead of yesterday 0:00 to 23:59.
  • Fixed a bug where the form builder would not show an error message when creating a new notification template if the email notification template directory path was not set.
  • Fixed a bug where the Save & Continue Later field was not available in GraphQL schema.
  • Fixed a bug where Dynamic Recipient fields would still send email notifications while hidden via Conditional Rules.
  • Fixed a bug where uploaded file attachments in email notifications showed a full file path instead of just the filename.
  • Fixed a bug where Stripe subscription plan names could possibly show up blank if no price plan description was provided. If so, Freeform will now autogenerate plan names.
  • Fixed a bug where the form builder didn't warn that author is a reserved handle name.
  • Adjusted the NL translation word for any in the conditional rules feature.
  • Fixed a bug where incorrectly including a twig file in the Success Template Directory path would break settings and form builder.
  • Fixed a bug where the Stripe Payments integration could be causing a customer as well as guest account in Stripe for the same transaction.
  • Fixed a bug where credit card numbers were not showing up in Stripe's payment methods for customer accounts.

Security

  • Addressed some potential XSS vulnerabilities.

Removed

  • Removed the old Pardot CRM and Constant Contact email marketing API integrations. Please switch to the newer Pardot and Constant Contact integrations if you haven't already, and delete the old legacy ones before upgrading to Freeform 4.
  • Removed the phpoffice/phpspreadsheet dependency to prevent install conflicts. Excel exporting inside Freeform is temporarily disabled until a new library is implemented.
  • Removed the league/flysystem dependency as it is not needed.
Last Updated: 11/21/2022, 3:11:27 PM