Download the PHP package boundstate/craft-contactform without Composer
On this page you can find all versions of the php package boundstate/craft-contactform. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package craft-contactform
Contact Form plugin for Craft
This plugin allows you to add an email contact form to your website.
Installation
To install Contact Form, follow these steps:
- Upload the contactform/ folder to your craft/plugins/ folder.
- Go to Settings > Plugins from your Craft control panel and enable the Contact Form plugin.
- Click on “Contact Form” to go to the plugin’s settings page, and configure the plugin how you’d like.
Usage
Your contact form template can look something like this:
The only required fields are “fromEmail” and “message”. Everything else is optional.
Redirecting after submit
If you have a ‘redirect’ hidden input, the user will get redirected to it upon successfully sending the email. The following variables can be used within the URL/path you set:
{fromName}
{fromEmail}
{subject}
For example, if you wanted to redirect to a “contact/thanks” page and pass the sender’s name to it, you could set the input like this:
<input type="hidden" name="redirect" value="contact/thanks?from={fromName}">
On your contact/thanks.html template, you can access that ‘from’ parameter using craft.request.getQuery():
Note that if you don’t include a ‘redirect’ input, the current page will get reloaded.
Adding additional fields
You can add additional fields to your form by splitting your “message” field into multiple fields, using an array syntax for the input names:
If you have a primary “Message” field, you should name it message[body]
, like in that example.
An email sent with the above form might result in the following message:
Phone: (555) 123-4567
Services: Design, Development
Hey guys, I really loved this simple contact form (I'm so tired of agencies
asking for everything but my social security number up front), so I trust
you guys know a thing or two about usability.
I run a small coffee shop and we want to start attracting more freelancer-
types to spend their days working from our shop (and sipping fine coffee!).
A clean new website with lots of social media integration would probably
help us out quite a bit there. Can you help us with that?
Hope to hear from you soon.
Cathy Chino
Overriding plugin settings
If you create a config file in your craft/config
folder called contactform.php
, you can override
the plugin’s settings in the control panel. Since that config file is fully multi-environment aware, this is
a handy way to have different settings across multiple environments.
Here’s what that config file might look like along with a list of all of the possible values you can override.
Dynamically adding email recipients (requires Craft 2.5+)
You can programatically add email recipients from your template by adding a hidden input field named “toEmail” like so:
<input type="hidden" name="toEmail" value="{{ '[email protected]'|hash }}">
If you want to add multiple recipients, you can provide a comma separated list of emails like so:
<input type="hidden" name="toEmail" value="{{ '[email protected],[email protected]'|hash }}">
Then from your craft/config/contactform.php
config file, you’ll need to add a bit of logic:
In this example if $toEmail
does not exist or fails validation (it was tampered with), the plugin will fallback to the “toEmail” defined in the plugin settings, so you must have that defined as well.
The “Honeypot” field
The Honeypot Captcha is a simple anti-spam technique, which greatly reduces the efficacy of spambots without expecting your visitors to decipher various tortured letterforms.
In brief, it works like this:
- You add a normal text field (our “honeypot”) to your form, and hide it using CSS.
- Normal (human) visitors won't fill out this invisible text field, but those crazy spambots will.
- The ContactForm plugin checks to see if the “honeypot” form field contains text. If it does, it assumes the form was submitted by “Evil People”, and ignores it (but pretends that everything is A-OK, so the evildoer is none the wiser).
Example “Honeypot” implementation
When naming your form field, it's probably best to avoid monikers such as “dieEvilSpammers”, in favour of something a little more tempting. For example:
In this case, you could hide your form field using the following CSS:
File attachments
If you would like your contact form to accept file attachments, follow these steps:
- Go to Settings > Plugins > Contact Form in your CP and make sure the plugin is set to allow attachments.
- Make sure your opening HTML
<form>
tag containsenctype="multipart/form-data"
. - Add a
<input type="file" name="attachment">
to your form. - If you want to allow multiple file attachments, use multiple
<input type="file" name="attachment[]">
inputs.
Ajax form submissions
You can optionally post contact form submissions over Ajax if you’d like. Just send a POST request to your site with all of the same data that would normally be sent:
The contactForm.beforeSend
event
Other plugins can be notified right before an email is sent with the Contact Form plugin, and they are even given a chance to prevent the email from getting sent at all.
The contactForm.beforeMessageCompile
event
Other plugins can list to this event to change the contents of the plain text body of the email as well as the HTML body.
Changelog
1.8.1
- Fixed a bug where the HTML body of an email was being escaped displaying HTML entities in the email.
1.8.0
- Added the ability for plugins to modify the email's plain text and HTML body via the
contactForm.beforeMessageCompile
event. - Fixed a bug where Twig code that was entered in the email body or subject was getting parsed.
1.7.0
- Added the ability to access individual message fields values via
message.messageFields
when a validation error occurred. For example, the value of the inputmessage[Phone]
can now be accessed viamessage.messageFields['Phone']
. - Custom message field values only have a single line break between them in the generated email body now, rather than two.
1.6.0
- 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. - The "prependSender" and "prependSubject" settings can now be empty strings.
- Fixed a bug where the "allowAttachments" config setting wasn't being respected.
1.5.0
- Added support for some Craft 2.5 features.
1.4.0
- Added support for passing
{fromName}
,{fromEmail}
, and{subject}
in the ‘redirect’ URL.
1.3.0
- 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
- Added honeypot captcha support
1.1.0
- 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
- Initial release