Release Notes for Contact Form

3.1.0 - 2024-03-11

Added Craft 5 compatibility.
Added a missing Dutch translation. (#257)
Fixed a bug where it wasn’t possible to upload a single file with the attachment param. (#254)

3.0.1 - 2023-03-16

Added translations for Email and Name. (#235)
Fixed an error that occurred if fromName was not specified on submissions. (#228)

3.0.0 - 2022-05-02

Added

Added Craft 4 compatibility.
Added the allowedMessageFields setting, which can be used to restrict which message fields are allowed to be submitted.

Changed

Failed submissions are now passed back to the template as a submission variable, instead of message.
The contact-form/send action now returns a 400 status on failure for Ajax requests.

2.5.2 - 2023-03-16

Added translations for Email and Name. (#235)

2.5.1 - 2022-05-02

Fixed

Fixed a bug where newlines were getting replaced with double newlines in message bodies. (#214)

2.5.0 - 2022-04-15

Added

Added the allowedMessageFields setting, which can be used to restrict which message fields are allowed to be submitted.

2.4.1 - 2022-04-12

Fixed

Fixed a potential PHP error.

2.4.0 - 2022-04-11

Changed

Custom message fields’ labels can now be translated using the site translation category. (#161)

2.3.0 - 2022-01-21

Changed

Craft 3.4 or later is now required.
The success flash message is now returned in the response for AJAX calls.
craft\contactform\models\Submission now supports EVENT_DEFINE_RULES. (#196)

2.2.7 - 2020-05-04

Changed

Added case-insensitive extension check for attachments.

2.2.6 - 2019-12-17

Changed

The Contact Form “To Email” setting can now be set to environment variables (e.g. $CONTACT_TO_EMAIL). (#179)
Contact Form now requires Craft 3.1 or later.

2.2.5 - 2019-05-31

Changed

Contact Form now respects Craft’s allowedFileExtensions config setting.
Contact Form now logs a warning instead of info to the log files when an email is flagged as spam. (#163)

2.2.4 - 2019-04-03

Fixed

Fixed an issue with Japanese Characters. (#158)

2.2.3 - 2018-11-13

Added

Contact Form is now translated into Dutch. (#139)

Fixed

Fixed a bug where the submission email address was not being validated. (#145)

2.2.2 - 2018-07-19

Fixed

Fixed a PHP error introduced in 2.2.1 that broke submissions that were using a single message form input.

2.2.1 - 2018-07-18

Fixed

Fixed a bug where blank messages wouldn’t fail validation if the message was split into multiple fields.

2.2.0 - 2018-07-18

Added

Contact Form is now translated into Arabic. (#125)

Changed

Contact emails no longer list the Name field if none was provided. (#126)
Event listeners for craft\contactform\Mailer::EVENT_BEFORE_SEND can now make changes to craft\contactform\events\SendEvent::$toEmails, and they will be respected. (#112)

Fixed

Fixed a bug where single carriage returns in email message bodies were being ignored. (#118)
Fixed a bug where HTML in email bodies wasn’t getting escaped. (#104)
Fixed an error that occurred when submitting a contact form with an empty file attachment field. (#116)

2.1.1 - 2017-12-04

Changed

Loosened the Craft CMS version requirement to allow any 3.x version.

2.1.0 - 2017-10-12

Added

Added German translations.

Changed

Email message bodies now include the sender’s name and email. (#97)

2.0.3 - 2017-09-15

Added

Craft 3 Beta 27 compatibility.

2.0.2 - 2017-07-07

Added

Craft 3 Beta 20 compatibility.

2.0.1 - 2017-06-12

Fixed

Fixed a bug where the message variable was not available to contact form templates when the submission contained validation errors.

2.0.0 - 2017-05-16

Added

Added Craft 3 compatibility.
Added the afterSend event.

Changed

The beforeSend event now has $submission and $message properties, set to the user submission model and the compiled email message, respectively.
The contactForm/sendMessage action is now contact-form/send.

Removed

Removed honeypot field support. (Moved to the contact-form-honeypot plugin.)
Removed the beforeMessageCompile event.
Removed the $isValid property from the beforeSend event. Use the beforeValidate event on the Submission model to prevent submissions from going through.

1.8.1 - 2016-09-02

Fixed

Fixed a bug where the HTML body of an email was being escaped displaying HTML entities in the email.

1.8.0 - 2016-08-18

Added

Added the ability for plugins to modify the email's plain text and HTML body via the contactForm.beforeMessageCompile event.

Fixed

Fixed a bug where Twig code that was entered in the email body or subject was getting parsed.

1.7.0 - 2016-01-18

Added

Added the ability to access individual message fields values via message.messageFields when a validation error occurred. For example, the value of the input message[Phone] can now be accessed via message.messageFields['Phone'].

Changed

Custom message field values only have a single line break between them in the generated email body now, rather than two.

1.6.0 - 2015-12-20

Added

Added the ability to attach multiple files to the contact email.
Added the ability to change the flash success message via the "successFlashMessage" setting.
Added the ability to override plugin settings via a craft/config/contactform.php config setting.

Changed

The "prependSender" and "prependSubject" settings can now be empty strings.

Fixed

Fixed a bug where the "allowAttachments" config setting wasn't being respected.

1.5.0 - 2015-12-20

Added

Added support for some Craft 2.5 features.

1.4.0 - 2014-06-01

Added

Added support for passing {fromName}, {fromEmail}, and {subject} in the ‘redirect’ URL.

1.3.0 - 2014-01-07

Added

Added support for multiple email addresses
Added the ContactFormService
Added the contactForm.beforeSend event, allowing third party plugins to add extra validation

1.2.0 - 2013-12-30

Added

Added honeypot captcha support

1.1.0 - 2013-12-04

Added

Added the ability to submit attachments
Added the ability to submit the form over Ajax
Added the ability to submit checkbox lists, which get compiled into comma-separated lists in the email

1.0.0 - 2013-10-03

Initial release