MW WP FormでreCAPTCHA導入の際、エラー「Invalid reCAPTCHA Secret key」が発生する場合の対処法

エラーの発生状況

MW WP FormでGoogle reCAPTCHAを有効にしたフォームを使用している際に、以下のエラーが表示されることがあります。

Invalid reCAPTCHA Secret key

一見するとreCAPTCHAの設定ミスを疑ってしまいがちですが、正しいキーを設定していてもこのエラーが表示されるケースがあります。よくあるケースは、Google reCAPTCHA導入だと思います。

原因

このエラーが発生する主な原因は、MW WP Formのショートコードをテーマファイルに直接記述していることです。

MW WP FormでreCAPTCHAを正常に動作させるには、ショートコードがWordPressのthe_content関数の処理を通過する必要があります。しかし、テーマファイルに直接ショートコードを書いた場合、この処理が実行されず、reCAPTCHAが動作しなくなります。

対処方法

エラーを解消するには、WordPressの管理画面でショートコードを入力する方法が最も簡単で確実です。

1. WordPressの管理画面にログインします。
2. エラーが発生しているフォームを使用している固定ページや投稿ページを編集します。
3. 本文エディタ内に以下のようにショートコードを入力します。
4. ページを保存または更新します。

[mwform_formkey key="フォームキー"]

これにより、ショートコードがthe_content関数を通過し、reCAPTCHAが正常に動作するようになります。

感想

テーマにショートコードを書いていると動かなくなる、という発想になりにくい。
ついサイトキーをコピペミスしたのではないか？と確認してしまう。

無駄な時が流れていく。