Contact Form 7 1.4

I released new version 1.4 of Contact Form 7 today. The main feature is spam filtering with Akismet.

日本語 / Japanese »

How to use Akismet on Contact Form 7

Step 1. You need Akismet plugin. If it is not activated yet, activate it first.

Step 2. Open Contact Form 7 admin page, and check “Apply Akismet” option which added to Options area.

Now, information of all sending activity through this form is sent to Akismet server and Akismet judges it. But at this time, almost all will be judged as spam. Because Akismet basically works for comments, it needs basic elements of comment, more specifically, author’s name, email, URL and comment content. But Contact Form 7 doesn’t know which field is author’s name, email, URL and content. So you have to tell it which field is to sent to Akismet. See step 3.

Step 3. Edit tags in form content to specify field sent to Akismet.

Four akismet-related options are added.

  • akismet:author — Sender’s name
    The data filled in this field will be sent to Akismet as sender’s name.
    Example: [text* your-name akismet:author]
  • akismet:author_email — Sender’s email address
    The data filled in this field will be sent to Akismet as sender’s email address.
    Example: [email* your-email akismet:author_email]
  • akismet:author_url — Sender’s URL
    The data filled in this field will be sent to Akismet as sender’s URL.
    Example: [text your-url akismet:author_url]
  • akismet:content — Content
    The data filled in this field will be sent to Akismet as content.
    Example: [textarea your-message akismet:content]

    akismet:content option was removed. See 1.4.1 release announce.

If there are two or more tags with same option, only first one is sent to Akismet.

That’s all. To make sure it works, you can test by sending “viagra-test-123” as sender’s name, it will be judged as spam. Yes, Viagra.

When a message is judged as spam, no mail will be sent to recipient. And sender sees response message which is same as message you see when mail server fails to send a mail. This is intended. Because responding “your message was judged as spam” might be good clue for real spammer, and responding “you must be a spammer” might make innocent person upset in case of false positive.

If you want to know if Akismet judged it as spam, see the border line carefully.

If spammed, border is orange.

Italian translation

I proudly announce that Contact Form 7 now bundles Italian translation. Bruno kindly created translation files and sent me them this week. It was big good surprise for me that this plugin has such world-wide users. Really exciting.

If you also create translation in your language, please let me know and let me include into Contact Form 7. Thank you.

Next release schedule

I’m planning to release next Contact Form 7 1.5 in October. Minor upgrade will be done as needed.

I’m challenging to include captcha for next release.

日本語 / Japanese

Contact Form 7 1.4 をリリースしました。目玉は Akismet によるスパムフィルタリングです。

Contact Form 7 上で Akismet を使うにはまず Akismet プラグインを有効化して、Contact Form 7 の管理ページで [Akismet を適用する] にチェックを入れます。

これでそのフォーム経由の送信行動がすべて Akismet のサーバに送られ審査されることになりますが、この時点ではほぼ毎回スパムと見なされることになるはずです。というのも、Akismet は基本的にコメントに対して審査を行うものなので、コメントの基本要素(書き手の名前、メールアドレス、URL、コメントの本文)を審査の基準として必要とします。ところが Contact Form 7 はどのフィールドが名前や URL に相当するのか知りません。そのためそれらを明示的に指定してやる必要があります。

Akismet に送られるフィールドを指定するためのフォームタグ用オプションが4つ追加されました。

  • akismet:author — 送信者の名前
    このフィールドの入力データは送信者の名前として Akismet に送られます。
    例: [text* your-name akismet:author]
  • akismet:author_email — 送信者のメールアドレス
    このフィールドの入力データは送信者のメールアドレスとして Akismet に送られます。
    例: [email* your-email akismet:author_email]
  • akismet:author_url — 送信者の URL
    このフィールドの入力データは送信者の URL として Akismet に送られます。
    例: [text your-url akismet:author_url]
  • akismet:content — 本文
    このフィールドの入力データは本文として Akismet に送られます。
    例: [textarea your-message akismet:content]

    akismet:content オプションは廃止されました。詳しくは 1.4.1 のリリース報告をご参照ください。

2つ以上のタグが同じオプションを持つ場合は、最初の1つだけが有効になります。

これで設定はすべてです。ちゃんと機能していることを確かめたい場合は、送信者の名前のフィールドに「viagra-test-123」と入力して送信してみてください。正しく機能していればスパムと審査されるはずです。

スパムと審査された場合はメールの送信は行われず、ブラウザにはメールサーバがメール送信に失敗したときと同じ応答メッセージが表示されます。これは意図して同じにしています。もし「あなたのメッセージはスパムとみなされました」というような応答メッセージを返したとすると、相手が本物のスパマーなら無用の手がかりを与えることになりますし、本当は正しい送信を Akismet がスパムと誤判断したとすると相手を怒らせてしまうかもしれず、どっちにしてもいいことはありません。

そうはいってもスパムとサーバの送信失敗の見分けがつかないのも困るので、スパムの場合は応答メッセージのボーダーラインの色をオレンジにしています。注意して見てみてください。

5 thoughts on “Contact Form 7 1.4

  1. Is there a way to add a drop down list or other means for having multiple selectable recipients in a form? Like if I wanted a email “x” form, where people could choose someone to contact?

  2. Joe,

    Good question. You can add drop down list by using tag [select]. If you can put the value of this tag into recipient address field, you can make what you want. But on current version, you can’t edit recipient address field with tag. I don’t think this spec neat, so I will change it in future version. Thanks for your comment and please check out future announce.

  3. Contact form 7 not working with WordPress 2.3. beta.

    Only text on Contact form Options page is:

    Thank you for creating with WordPress | Documentation | Feedback | You are using a development version (2.3-RC1). Cool! Please stay updated.

    Any input would help!

    Thanks, Jane

  4. Jane,

    So you’re seeing almost empty page, right? Hmm… I have no clue why such a trouble occurs. Many sites are using Contact Form 7 on WordPress 2.3 beta, but I haven’t heard issues like that so far.

    Which server are you using? Apache? IIS?

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 )

Twitter picture

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

Facebook photo

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

Google+ photo

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

Connecting to %s