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.

Comments

1,401 responses to “Contact Form 7”

  1. Great plugin, thanks for realease.

  2. I can`t make it work with a custom language… I followed the tutorial but the language does not change..

  3. […] for me and will hopefully work for you too .Assuming you’ve downloaded, installed and activated Contact Form 7, log into your wordpress dashboard and click on Contact in the Left Sidebar.Configuring the form […]

  4. Great plugin, thanks.

    Miley.

  5. Great plugin, thanks for realease.

    Sarah.

  6. Thank you for this. Just donated some dollars. Keep it up.

  7. love contact form 7!

  8. Absolutely love it. Very simple to understand and lot’s of possibilitys.

  9. Thanks for the Contact*Form, it is a great plugin. Where can I donate a few Euros for it. Lot of thanks to the progammer.

  10. Thanks. For Euros, please use this link.

    Donate

  11. Hi, I set up one form with six fields, but in the email doesn´t come with totaly, only with the name, email, and other field as subject.
    I need to receive a complete form. Why dont work good.
    I wait for your answer. Thanks.

  12. This is very useful plugin, I just noticed that I don’t have a contact form on my site. This is good to test this plugin. Thanks for sharing ^^

  13. que tal si quiero definir un value en los select, por ejemplo.

    China
    India
    other

    gracias de antemano

  14. neat little plug-in, thanks for sharing.

  15. Thax for this its great plugging……….

  16. […] Page d’auteur de la page Formulaire de contact de 7 | Formulaire de contact 7 sur WordPress.org […]

  17. Thanks for this plugin, it has made creating forms for WordPress easy and painless =)

  18. I love this plugin.

  19. It’s simple and it works. Great stuff!!!
    Thank you for this plugin.

  20. It’s simple and it works.
    Thanks. Miley.

  21. Wow what a comments, must be a great plugin!

  22. Great plugin. Very thanks !
    Angel.

  23. This is the best contact form plugin for WordPress. Well done guys =)

  24. Well I have to say that i have been using wordpress again and that this plugin is absolutely one of my favorites now.

  25. Thanks for the Contact Form. Great plugin.

  26. bluantinoo Avatar
    bluantinoo

    will CF7 ever handle the HTML5 input type=”date” ?

  27. great plugin and it’s simple to use too.

  28. Great plugin. Very thanks

    Miley.

  29. Ive been using this one on my WP blog and works really great.

  30. Great. Thanks for share. Perfect plugin.
    Curtis.

  31. Sylvia Avatar
    Sylvia

    To the dev : I love you ღ◕‿◕。

  32. nice plugin. i will try this one out. thanks !

  33. like “Contact Form 7” better than “cformsII”!!!

  34. Excellent plugin, by far the best form plugin for WordPress. Thanks =)

  35. […] have a simple WordPress site with the Contact Form 7 plugin. When submitting a form via the site it can takes in excess of 30 seconds to […]

  36. Its a great plugin.
    I want to save the all contact in database.
    How is it possible.

    Please help me

    Thanks

  37. i definitely suggest this plugin.. Thanks for sharing..

  38. Nice plugin and very good information

  39. I always get the red message. Do I have to change something else?

  40. I also use this plugin. But wordpress can prevent some spams anyway thanks for sharing.

  41. Thanks for this article, it explained some not clear thing about the CF7, but I still cannot get the right style on my site.

  42. Thanks a lot for this plugin, it prooved to be very useful for me.

  43. thank you for information it make to my work is very easy step.

  44. Shinotaku Avatar
    Shinotaku

    Thank you for this plug-in! I just want to know if there is a way to check the fields according to what they are related.
    It works for email but i would like to check for numbers only (like telephone or postal code) thanks again for the plug in!!

  45. This is the only plugin i use for every WP installation!

  46. very useful plugin, thanks for share!

Leave a comment