Categories
WordPress Plugins

Contact Form 7

This post is no longer updated. Move to Contact Form 7 official site.


Download | Plugin Homepage | FAQ | Support Forum

(日本語の説明はこちら)

Summary

screenshot

Just another contact form plugin. Simple but flexible.

  • Supports multiple contact forms.
  • You can customize form and mail contents with simple markup.
  • AJAX submitting with jQuery Form Plugin.
  • Spam filtering with Akismet.
  • Bot prevention with CAPTCHA.

Download and Install

Download the latest release from WordPress.org plugin directory.

  1. Upload whole contact-form-7 folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress

Usage

  1. Open admin page [Options] – [Contact Form 7] [Manage] – [Contact Form 7].

    Update: If you are using WordPress 2.7 or greater, you can find the admin page under [Tools] – [Contact Form 7].

  2. Edit default “Contact form 1” or add new and save it.
  3. Copy [contact-form ...] code and paste it into the content of any posts you need the contact form.

FAQ

See Contact Form 7 FAQ

How to customize form and mail contents

You can use “tags” in several fields. Contact Form 7’s “tag” is formed string enclosed in square brackets [].

A tag used in form content is replaced by HTML form control element like <input> or <textarea>.

A tag used in mail template is replaced by user input of element with the same name.

wpcf7-desc

In this picture, a tag [textarea your-message ...] inserted in form content is replaced by <textarea> tag with name="your-message" attribute.

When a visitor input into this <textarea> field and submit, Contact Form 7 generates a mail based on mail template. Since message body field has [your-message] tag, this tag replaced by the user input message.

Tags in form content

You can use the following types of tags in form content.

Type Replaced by Validated as
text <input type="text" /> Any text
text* <input type="text" /> Any text / Required
email <input type="text" /> Email address
email* <input type="text" /> Email address / Required
textarea <textarea> </textarea> Any text
textarea* <textarea> </textarea> Any text / Required
select <select> </select>
select+ <select> </select>
checkbox <input type="checkbox" /> ...
checkbox+ <input type="checkbox" /> ...
radio <input type="radio" /> ...
captchac <img /> CAPTCHA
See How to use CAPTCHA
captchar <input type="text" />
submit <input type="submit" />

The syntax of tag is not so easy. You can use Generate Tag menu under Form textarea to make a tag you need.

I show you some examples of tags.

  • [text your-name 40/100 "John Smith"]

    This tag is replaced with:
    <input type="text" name="your-name" size="40" maxlength="100" value="John Smith" />

  • [email* your-email 60/ id:email]

    <input type="text" name="your-email" id="email" size="60" />

  • [textarea your-message 80x15 "Write message here."]

    <textarea name="your-message" cols="80" rows="15">Write message here.</textarea>

  • [select your-country "China" "India" "other"]
    <select name="your-country">
      <option value="China">China</option>
      <option value="India">India</option>
      <option value="other">other</option>
    </select>

I wrote about tag syntax.

How to use Akismet on Contact Form 7

1. You need Akismet plugin. If you have not activated it yet, activate it first.
2. Open Contact Form 7’s admin page and edit Form text area as:

  • Add akismet:author option to the tag of field which requires sender’s name.
    Example: [text* your-name akismet:author]
  • Add akismet:author_email option to the tag of field which requires sender’s email address.
    Example: [email* your-email akismet:author_email]
  • Add akismet:author_url option to the tag of field which requires sender’s URL.
    Example: [text your-url akismet:author_url]

Once you have activated the Akismet plugin and at least one of the akismet: options is set, Contact Form 7 will send all of a sender’s input as well as any other information related to input activity to the Akismet server. Akismet will then judge whether this input is likely to be spam.

When Akismet judges a message as spam, Contact Form 7 sends no mail and shows a response message with an orange border line (the third example in the picture below).

To make sure the spam filtering is working, send a message with “viagra-test-123” as the sender’s name. If the test is a success, the message will be judged as spam.

Changelog

0.9 (2007/04/30)
Initial release.
1.0 (2007/05/20)
Tag helper.
1.1 (2007/08/02)
File restructuring.
1.2 (2007/08/16)
jQuery Form Plugin introduced.
1.3 (2007/08/26)
New tag type: [select]
1.3.1 (2007/08/26)
Critical bug about JavaScript loading fixed.
1.3.2 (2007/09/03)
Bug fix around jQuery.
1.4 (2007/09/07)
Akismet spam filtering introduced.
1.4.1 (2007/09/11)
Add Spanish and Catalan translations.
1.4.2 (2007/09/13)
Add German translation.
1.4.3 (2007/09/15)
Add Polish translation.
1.4.4 (2007/09/17)
Add French translation.
1.5 (2007/10/07)
CAPTCHA introduced.
1.6 (2007/10/17)
Mail (2) and UI improvement for admin page.
1.6.1 (2007/10/27)
Sidebar widget support.
1.7 (2007/11/27)
New tag type: [select+], [checkbox], [checkbox+] and [radio]
1.7.1 (2007/12/06)
Made wpcf7 variable global. Polish translation updated.
1.7.2 (2007/12/13)
Bugfix. Czech translation added.
1.7.3 (2007/12/23)
New default: and label-first options added.
1.7.4 (2007/12/30)
select+ and checkbox+ tag types removed. multiple and exclusive options added.
1.7.5 (2008/01/26)
Two fixes and include_blank option.
1.7.6 (2008/03/02)
New acceptance tag added.

1,401 replies on “Contact Form 7”

How do I style the forms?

In CSS do I put wpcf7-validates-as-required ? any pointers or info would be great.

thanks

I’ve set up a form, and it successfully sends a message, but it does not show the “Thank you” message. Instead, it goes to the “Page not found” screen. There are no error messages in the Firebug console.

Hi,

Thanks a lot for your great work!

A quick question : do you expect to implement date tags in your plugin? – It’s in my opinion the only one thing that is actually missing.

A JS calendar that makes you able to select a date…

Thank you for everything!

Cheers,
Alexis

Hello,

After I tried to discuss my problem regarding to the contact form here :-
https://ideasilo.wordpress.com/2009/09/02/contact-form-7-2-0-2/comment-page-1/#comment-13615

I try it again after 10 days to find the solution of the problem.

1) How to load the Javascript files (or the plugin itself) only on one of the contact page (instead of loading it on the whole website where it is not needed!!!!)

2) How to move the javascript files to be loaded in the FOOTER instead of header.

If anybody please can help me or point me to some solution in internet I shall be very thankful.

Regards.

Devin

While a halfway decent plugin, I would’ve appreciated having a little more control over the styling, as there’s very minimal tag IDs to target CSS with. Using paragraph tags without any sort of ID (or a class) is making it really hard to customise the form without having to dig through piles of code.

Second, PLEASE use label tags for denoting form fields. There’s absolutely no reason not to use them: they make navigating an interface a hell of a lot easier (clicking a label brings the input focus to the attached input field), and it helps provide better placement control amidst convoluted layers of CSS. While it might sound like a nitpick (and I confess to being pretty banal about the subject), the fact that so many developers don’t bother making use of label tags when coding is really a nuisance.

I would like to report a possible bug when you use Contact Form 7 with multiple forms.

With multiple forms created, when I change the messages and the additional settings, they do not save under the right form. Instead, the form uses everything from the first form.

For example, I have changed the messages and additional settings for my second, third and fourth form. When a user submits the second form, the additional settings code from the first form is triggered. Whereas, the additional settings code for the second form did not trigger.

Is there a possible solution to this?

Hello,

Great plugin! Is there a way to direct a user to another page after they submit their form?

I tried to embed a URL in the “success” message and noticed that it doesn’t render into HTML. Is there a way to do this if I cannot do a redirect?

Thank you for your attention and response!

My Contact Form 7 of the Word Press error to upload a large file.?
When you attach a file to the form he carries a message of error ”
upload a file failed for some reason “and” Validation Errors “wanted
know if you have any solution for this.

I need to develope a automatic responder (a message to setup as default to send on every mail received) in the form mail inside my website.

Can I setup, this feauture, to this plugin?

[…] Contact Form 7 – Cine vrea o pagină de contact o poate avea în câteva secunde. Cine vrea să poată crea şi, să zicem, chestionare mai complicate sau diverse formulare ale căror date să fie trimise prin email cuiva, poate folosi de asemenea Contact Form 7 cu succes. Faptul că pluginul este bine menţinut la zi şi are traducere în limba română sunt argumente suplimentare. […]

Hello,

I am having a very difficult time trying to get my contact 7 form working. I changed themes and now it will not work. Any assistance would be greatly appreciated. It tells me the form has been sent, although I do not receive anything in my email.

Thank you in advance

hi,

can anybody help me with the drop down menu tags… i have a form in which i have an option of drop down menu.. and i want the option to appear in the email that is sent to me once the form is submitted… but i cant find the tag to add in the email message area…

Hallo,

I’m having same problem as Brian, but I don’t seem to read the answer to his problem in here.

Anyone know what can I do if:
Once I set up a form, it successfully sends a message, but it does not show the “Thank you” or “Validation Error” or “Spam” message.
Instead, it goes to the “ERROR 404-Page not found” screen.

What can it be???
I’ve used this form before in another website I did and it worked without problem.

I’ll appreciate your help thanx!

Hallo,

In case someone had this same problem as me. I didn’t have any response here, but found the answer in the Support Forum.

You can solve the ERROR 404 Page submitting page with:
“I had this same issue, and strangely enough, I fixed it by switching a field I created called [name] to [your-name]. Not sure why that caused a problem but it seems to have done the trick.”

And indeed that was the only trick.

Hi

I personally prefer Contact Form 7 since it’s so easy to install and get started with it. Just by simple activating the plugin you will have a fully functional contact form, without any hassle.

kinza

Hey thre I was hoping you might have an idea of what is causing a problem I have when I install and activate your plugin.

When I make the Contact Form 7 activate it then causes the the following problem in my admin section:

Theme: ThrillingTheme 1.1 by Cody McKibben

I have the following Plugins activate:
Akismet Version 2.2.7
All in One SEO Pack Version 1.6.10
flickrRSS Version 5.1
Google Calendar Widget Version 1.0
MailChimp Version 1.1.8
Redirection Version 2.1.24
What Would Seth Godin Do Version 1.7
WordPress Database Backup Version 2.2.2
WordPress Related Posts Version 1.1.1
WPtouch iPhone Theme Version 1.9.7.4

Not Activate
rpx Version 0.2.4
Contact Form 7 Version 2.0.7

Do you think there is a confict with between some of these? Any suggestions of where to hunt this down? SHould I contact the Contact Form 7 people?

Thanks.

Darrin

Hi, i would like to know if what im trying to do is possible, im using contact form7 for a simple online voting, im trying to create a list of 50 with a maximum of 20 selection using checkbox,

what i would like to do is, when a user checked more than 20 on the list, the system must check and verify the checkedbox and prompt the user if it is more than 20.

im really eager to do this, please help me find my solution. thanks so much

Hi, the last version of Contact Form 7 , don’t work fine, the input boxes disapear and only i see the origial [text] to make the forms…
I’m downgrade to 2.1.0 and work fine.
Please Check the last version.
Regards,

Max Sorribas

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s