Contact Form 7

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

Download | Plugin Homepage | FAQ | Support Forum

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

Summary

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.

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.

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.