Form to Email Plugin

formToEmail Plugin allows you to add forms to your pages.

The content of the form will be sent via email to any email address (or addresses) you specify.

Sample usage

You would add something similar to this to one of your pages:

[formToEmail]

[subject=Message from {1}] [to=your@email.address][from={2}]

[Your Name:|text|required]

[Your Email:|text|required]

[Your Message:|textarea|required]

[/formToEmail]

Fields are specified by [LABEL|INPUT TYPE|REQUIRED FLAG]

Only LABEL and INPUT TYPE are necessary to add a field to the form. INPUT TYPE can be: text or textarea.

Additional data

To specify where to send the email, use:

[to=YOUR ADDRESS HERE] You can specify several addresses separated by commas

To specify what address to use as the sender, use:

[from=EMAIL ADDRESS]

To add a custom subject use:

[subject=YOUR SUBJECT]

To customize your "Thank you" message (message that appears after the user has successfully submitted the form) use:

[thankYouMessage=YOUR MESSAGE] (do not use html in this message)

Numbers in brackets {} will be replaced by data supplied by user when the form is submitted. In this way, you can use an email address as the "from" attribute of the email or use the name entered as part of the subject for example. Numbers indicate field order. In the above example, "Your Name:" is number 1, and "Your email:" is number 2.

Formatting

Between the form fields, you can add html markup. You can also add html markup inside the brackets if, for example, you wanted to make the labels bold, or to add a break between the label and the form field.

Note: This plugin only handles one form per page.

2 responses to "Form to Email Plugin"

Kevin L.

Kevin L.  on December 02, 2008

Laura,
I can get the plugin to show the form and it seems to function correctly but I never receive an email when the form is used. Is there something special about the [to=email] part of the code that I might need to know?
Thanks
Laura

Laura  on December 04, 2008

Kevin,
Are you able to receive email in other places, like when someone writes a comment? I would check the undeliverable folder in CF and the mail logs in the CF administrator to see what the problem might be.

Leave a Comment