Tech
Contact Form 7で「その他」に自由記入欄を付ける方法
チェックボックスとラジオボタンの free_text オプションを使うと、最後の選択肢の横に自由記入欄を1つ置けます。
6.2.3の実コードとPHP 8.3.6の実行結果から、届く値の作られ方と3つの落とし穴、回避のコードまでまとめます。
お問い合わせフォームの「ご相談内容」を選択式にすると、最後に必ず「その他」が必要になります。
そして「その他」を選ぶ人は、たいてい何を相談したいのかを書きたがります。
選択肢の横に小さな入力欄を1つ置きたい、という要望です。
Contact Form 7 には、この用途のオプションが標準で入っています。free_text です。
ただしフォーム編集画面のタグ生成ツールには項目として出てこないため、存在を知らないと見つかりません。
そして届くメールに入る値は、多くの人が想像する形とは違う作られ方をします。
この記事では Contact Form 7 6.2.3 の配布zipを実際に取得し、modules/checkbox.php の実装を読んだうえで、送信値を組み立てる処理と同じ手順を PHP 8.3.6 で実行して確かめた結果をまとめます。
書き方だけでなく、受託でフォームを納品するときに踏む3つの落とし穴と、その回避コードまで扱います。
free_text オプションの書き方
フォームタグの末尾にオプション名を書き足すだけです。
[checkbox your-choice "ホームページ制作" "保守・運用" "その他" free_text]
これで「その他」の右側にテキスト入力欄が1つ出ます。
ラジオボタンでも同じです。
[radio how-found "検索" "知人の紹介" "その他" free_text]
必須にする場合はタグの型に * を付けます。
[checkbox* your-choice "ホームページ制作" "保守・運用" "その他" free_text]
注意する点が1つあります。
6.2.3 のタグ生成ツールには free_text のチェックボックスがありません。
配布zip内の admin/includes/tag-generator.php を free_text で検索しても1件もヒットせず、生成ツールが出すのはフィールド名・クラス・選択肢・「最初の項目をラベルとして使用する」「ラベル要素で囲む」までです。
生成ツールでタグを作ってから、エディタ上で free_text を手で足す流れになります。
出力されるHTMLと、入力欄の置かれる場所
modules/checkbox.php の157行から173行が、自由記入欄を出している箇所です。
選択肢を1つずつ回すループの最後の1周のときだけ、テキスト入力欄を追加します。
実際に出るHTMLは次の形です。
<span class="wpcf7-list-item last has-free-text">
<label>
<input type="checkbox" name="your-choice[]" value="その他" />
<span class="wpcf7-list-item-label">その他</span>
</label>
<input type="text" name="_wpcf7_free_text_your-choice" class="wpcf7-free-text" />
</span>
ここから分かることが3つあります。
1つ目は、入力欄のname属性が _wpcf7_free_text_ + フィールド名になることです。
後述しますが、この命名が「自由記入欄だけをメールに出せない」理由になります。
2つ目は、入力欄が <label> の外に置かれることです。
ソース上は use_label_element によるラベル要素での囲み込みが138行で先に終わり、そのあと157行で入力欄が足されます。
したがって自由記入欄にはラベルが紐付いていません。
スクリーンリーダーで読み上げたとき、この欄が何の欄なのか分かりません。
フォーム全体の読み上げ構造についてはContact Form 7のアクセシビリティでまとめています。
3つ目は、囲みのspanに has-free-text クラスが付くことです。
入力欄の幅を調整したい場合は、このクラスか .wpcf7-free-text を使います。
初期状態ではブラウザ既定の幅のままで、スマートフォンでは窮屈に見えます。
.wpcf7-list-item.has-free-text {
display: block;
}
.wpcf7-free-text {
width: 100%;
max-width: 24em;
margin-top: 4px;
font-size: 16px; /* iOSの自動ズーム防止 */
}
なお、入力エラーで戻ってきたときに書いた内容が消えないよう、本体は wpcf7_is_posted() が真のときだけ value 属性に直前の入力を戻しています(168行)。
この復元は自由記入欄にも効きます。
送信される値は「最後の選択肢 + 半角スペース + 記入内容」です
ここが本題です。
自由記入欄の内容は、独立した項目としては届きません。modules/checkbox.php の326行から342行にある wpcf7_posted_data_checkbox() が、送信された選択値の配列を加工します。
処理は次の順です。
- 選択値を配列にする
_wpcf7_free_text_<フィールド名>のPOST値を取る- 配列の最後の要素を取り出す
- 「取り出した値 + 半角スペース + 記入内容」を作り、
trim()して配列に戻す
この処理と、POST値から前後の空白を落とす本体の処理(includes/functions.php の wpcf7_superglobal())を同じ順序で再現し、PHP 8.3.6 で実行した結果が次の表です。
フォームタグは [checkbox your-choice "制作" "保守" "その他" free_text] を想定しています。
| 選択した項目 | 自由記入欄 | 送信データになる値 |
|---|---|---|
| その他 | ECサイトの改修 | ["その他 ECサイトの改修"] |
| 保守 | ECサイトの改修 | ["保守 ECサイトの改修"] |
| 制作・その他 | LP1枚 | ["制作", "その他 LP1枚"] |
| その他 | (空) | ["その他"] |
| (未選択) | ECサイトの改修 | [] |
| 制作(free_textなし) | XYZ | ["制作"] |
想定どおりなのは1行目だけです。
残りの5行はどれも、納品後に問い合わせを受ける形です。
順に見ていきます。
落とし穴1:記入欄は「その他が選ばれたか」を見ていません
表の2行目です。
「保守」だけを選んだ人が自由記入欄に文字を入れると、「保守 ECサイトの改修」という値になります。
自由記入欄は、選択肢とは別の独立したテキスト入力です。
チェックされているかどうかに関係なく、フォームを送れば必ず一緒に送信されます。
そして値を組み立てる処理は「その他」という文字列を特別扱いしていません。
配列の最後の要素に、無条件でつなぎます。
実際に起きるのは次のような事故です。
- 「その他」の欄が目立つので、選択肢を選んだ人がメモ欄のつもりで書いてしまう
- 「その他」をいったん選んで記入し、気が変わって別の選択肢に変えたが、記入欄は消し忘れた
- ブラウザの自動入力が、名前のない入力欄に過去の入力を埋めた
いずれの場合も、届くメールは「保守 ECサイトの改修」のような1つの文字列です。
問い合わせ区分で自動的に振り分けている場合、完全一致の条件から外れて振り分けが効かなくなります。
宛先の出し分けを条件で書いている場合はContact Form 7で宛先を出し分ける方法の注意点とあわせて見てください。
対策は2つあります。
1つは、記入欄が「その他」専用であることを画面上ではっきりさせることです。
選択肢のラベルを「その他(右の欄にご記入ください)」のように書き、CSSで記入欄を次の行に落とします。
もう1つは、後述するバリデーションで「その他が未選択なのに記入欄に文字がある」場合を弾くことです。
表の5行目も同じ原因です。
何も選択せずに記入欄だけ書いた場合、書いた内容は丸ごと捨てられます。
配列が空なので、つなぐ相手が存在しないからです。
必須にしていなければエラーも出ず、送信は成功します。
書いた本人は送れたと思い、こちらには空の値だけが届きます。
必須([checkbox*])にしておけば、少なくとも選択を促すエラーが出ます。
落とし穴2:選択肢の検証が丸ごと外れます
Contact Form 7 は、送信された値がフォームに定義した選択肢のどれかであることを検証しています。modules/checkbox.php の237行以降にある wpcf7_swv_add_checkbox_enum_rules() が、選択肢の一覧を enum ルールとして登録し、定義外の値には「このフィールドで未定義の値が使用されました。
」というエラーを返します。
開発者ツールで value を書き換えて送るような改ざんを弾く仕組みです。
ところが246行から248行に、次の分岐があります。
if ( $tag->has_option( 'free_text' ) ) {
$values[$tag->name] = 'free_text';
}
選択肢の配列であるべき場所に、文字列 'free_text' を入れています。
そして277行で、配列でないものは continue でスキップします。
結果としてfree_text を付けたフィールドには enum ルールが1つも登録されません。
自由記入欄の中身は当然どんな文字列でも通す必要があるので、実装としては筋が通っています。
ただし副作用として、選択肢の側に定義外の値を送っても素通りします。
「その他 任意の文字列」だけでなく、「存在しない選択肢名」でもそのまま受け付けます。
必須の検証(required)と、ラジオボタンや exclusive 付きチェックボックスの「1つまで」の検証(maxitems)は別のルールなので、こちらは free_text を付けても残ります。
外れるのは選択肢の列挙チェックだけです。
実害が出やすいのは、フォームの値をそのまま後続処理に渡している場合です。
選択値で宛先を変える、選択値をCRMの項目にマッピングする、選択値を集計してグラフにする。
いずれも「定義した選択肢のどれかである」という前提が崩れます。
free_text を使うフィールドの値は、受け取った側で必ず突き合わせてから使ってください。
送信値の形を確かめる前に
届いた値がメールにしか残っていないと、連結の事故に気づけません
Contact Form 7 の標準では、送信内容はメールとしてしか残りません。「保守 ECサイトの改修」のような連結が起きていても、1通ずつ読むまで気づけないということです。Frontierline Forms は送信内容のデータベース保存とCSV書き出しを無料版に含んでいるため、管理画面で一覧として見返せます。選択式の項目に想定外の値が混ざっていないかを、まとめて確認できる状態にしておくと点検が早く終わります。
落とし穴3:記入欄だけをメールの別行に出すことはできません
「選択肢は選択肢の行に、自由記入は別の行に出したい」という要望は必ず出ます。
結論から書くと、標準の機能ではできません。
理由は本体のデータ組み立て処理にあります。includes/submission.php の353行から360行で、送信データは次のように作られます。
$posted_data = array_filter(
(array) $_POST,
static function ( $key ) {
return ! str_starts_with( $key, '_' );
},
ARRAY_FILTER_USE_KEY
);
アンダースコアで始まるPOSTキーを、すべて除外しています。
自由記入欄のname属性は _wpcf7_free_text_your-choice なので、この時点で落ちます。
落ちたうえで、先ほどの連結処理によって選択値の側に合流します。
したがってメール本文に次のように書いても、置換されません。
相談内容:[your-choice]
その他の内容:[_wpcf7_free_text_your-choice]
includes/mail.php の645行で、対応する値が見つからなかったメールタグは return $tag; でそのまま返されます。
つまりメール本文に [_wpcf7_free_text_your-choice] という文字列がそのまま出ます。
送信テストで気づければよいのですが、気づかないまま納品すると全件のメールに角括弧付きの文字列が並びます。
メールタグの基本的な挙動はContact Form 7のメールタグ一覧と使い方にまとめています。
この除外はデータベース保存やCSV書き出しにも同じように効きます。
保存先に渡るのは連結済みの1つの値だけで、記入欄の内容が独立した列になることはありません。
集計で「その他」の中身を分けたい場合は、受け取ったあとに最初の半角スペースで分割する前提で設計してください。
送信内容の保存そのものについてはContact Form 7の送信内容をデータベースに保存する方法で扱っています。
どうしても独立した項目として残したい場合は、free_text を使わずに通常のテキストフィールドを別タグとして置きます。
[checkbox your-choice "制作" "保守" "その他"]
[text your-choice-other placeholder "その他の場合はご記入ください"]
こうすれば [your-choice-other] というメールタグが使え、保存先でも独立した項目になります。
見た目の並びは崩れますが、値の扱いは素直です。
「その他」を選んだときだけ表示したい場合は、Contact Form 7で条件分岐を実装する方法の出し分けと組み合わせます。
メール本文での見え方と、区切り文字
複数選択できるチェックボックスの場合、メールタグは配列を文字列に直してから出力します。includes/mail.php の597行から603行で区切り文字が決まります。
- メール本文(body)のとき:WordPress の
wp_get_list_item_separator()が返す区切り(日本語環境では読点) - 件名やヘッダーのとき:半角カンマ + 半角スペース
したがって「制作」と「その他 LP1枚」を選んだ場合、本文には次のように入ります。
制作、その他 LP1枚
選択肢の区切りは読点、自由記入との区切りは半角スペースという2種類の区切りが1行に混ざります。
受け取った側でプログラム的に分解するときは、まず読点で分け、各要素の最初の半角スペースで分ける、という順になります。
自由記入の内容そのものに読点が入っていると分解できないため、機械処理を前提にするなら前節の別タグ方式を選んでください。
自由記入欄を必須にする、ずれた入力を弾く
標準では、必須(*)の判定は選択肢にしか働きません。
「その他」を選んで記入欄を空のまま送れば、値は ["その他"] になって送信が通ります。
何を相談したいのかが分からない問い合わせが届くということです。
検証用のフィルターは wpcf7_validate_{型} という名前で、型にはアスタリスクまで含まれます(includes/submission.php 579行)。
そのため必須のチェックボックスには wpcf7_validate_checkbox* を、ラジオボタンには wpcf7_validate_radio を登録します。
次のコードを functions.php か mu-plugins に置きます。
add_filter( 'wpcf7_validate_checkbox', 'fl_cf7_require_free_text', 20, 2 );
add_filter( 'wpcf7_validate_checkbox*', 'fl_cf7_require_free_text', 20, 2 );
add_filter( 'wpcf7_validate_radio', 'fl_cf7_require_free_text', 20, 2 );
function fl_cf7_require_free_text( $result, $tag ) {
if ( ! $tag->has_option( 'free_text' ) ) {
return $result;
}
$name = $tag->name;
$key = '_wpcf7_free_text_' . $name;
$selected = isset( $_POST[ $name ] )
? array_map( 'sanitize_text_field', (array) wp_unslash( $_POST[ $name ] ) )
: array();
$free_text = isset( $_POST[ $key ] )
? trim( sanitize_text_field( wp_unslash( $_POST[ $key ] ) ) )
: '';
$values = (array) $tag->values;
$last_item = (string) end( $values ); // 自由記入欄が付く選択肢=最後の1つ
$chose_last = in_array( $last_item, $selected, true );
if ( $chose_last and '' === $free_text ) {
$result->invalidate( $tag, '「' . $last_item . '」を選んだ場合は、右の欄に内容をご記入ください。' );
}
if ( ! $chose_last and '' !== $free_text ) {
$result->invalidate( $tag, '記入欄に入力がありますので、「' . $last_item . '」も選択してください。' );
}
return $result;
}
前半が落とし穴1の後半(記入欄が空のまま送られる)への対処、後半が落とし穴1の前半(選んでいないのに書かれる)への対処です。
どちらも $result->invalidate( $tag, メッセージ ) でフィールド単位のエラーにしているので、エラー文はその項目の下に表示されます。
優先度を20にしているのは、本体のスキーマ検証(SWV)が先に走り終わった状態で判定するためです。
必須チェックと二重にエラーを出さずに済みます。
この処理をサーバー側に置くことが重要です。
JavaScriptだけでチェックすると、落とし穴2で書いたとおり選択肢の検証が外れているため、直接POSTされた場合に何の歯止めもなくなります。
検証した環境
この記事の挙動は、次の条件で確認しています。
- Contact Form 7 6.2.3 の配布zipを
downloads.wordpress.orgから取得(368,433バイト・md568b35dd1c8c1946bf8ec85a56d1763c0) - 読んだファイル:
modules/checkbox.php(10,386バイト・453行・md5960d41cc556cc723f6d0f537608be3ad)、includes/submission.php、includes/mail.php、includes/functions.php、admin/includes/tag-generator.php - 送信値の組み立て(326行から342行)と、POST値の前後空白除去を同じ順序で再現し、PHP 8.3.6 で実行して表の6パターンを取得
free_textという文字列の出現箇所は zip全体で17件。うちタグ生成ツール(admin/includes/tag-generator.php)は0件
バージョンが上がったときに挙動が変わる可能性がある箇所は、連結の仕様(326行付近)と enum ルールの除外(246行付近)の2つです。
6.2系の変更点はContact Form 7 6.2の変更点にまとめています。
まとめ
free_text は、1行足すだけで「その他」の自由記入欄が作れる便利なオプションです。
ただし値の作られ方に癖があります。
- 記入欄の内容は独立した項目にならず、選択値の配列の最後の要素に半角スペースでつながります
- つなぐ相手は「その他」とは限りません。選ばれた選択肢の最後の1つです
- free_text を付けたフィールドは、選択肢の列挙チェック(enum)が外れます
- 記入欄のname属性はアンダースコア始まりのため、メールにも保存先にも単独では残りません
選択肢の数が少なく、届いたメールを人が読んで対応する運用なら、free_text のままで十分です。
値を機械的に扱うなら、通常のテキストフィールドを別に置いて条件分岐で出し分ける方が、あとから壊れません。
どちらを選ぶかは、そのフォームの値を誰が読むかで決めてください。
Frontierline Forms
選択式の項目こそ、送信内容を一覧で見返せる状態にしておきます
自由記入欄の連結も、未定義の選択値も、メールを1通ずつ読んでいる限りは見つかりません。Frontierline Forms は確認画面・マルチステップ・送信内容のデータベース保存・CSV書き出しを無料版に含んでいます。管理画面に記録が残っていれば、選択式の項目に想定外の値が混ざった日を後から特定でき、CSVに書き出して集計もできます。定番の要件をプラグイン側へ寄せてから、残った部分だけをコードで足す順番が安全です。
よくある質問
「その他」の自由記入欄はプラグインなしで作れますか。
作れます。
チェックボックスとラジオボタンのフォームタグに free_text オプションを書き足すと、最後の選択肢の横にテキスト入力欄が1つ出ます。
ただしタグ生成ツールのボタンにはこの項目がないため、タグを手で書き足す必要があります。
自由記入欄は1つのフォームタグに複数置けますか。
置けません。free_text で出る入力欄は、選択肢のうち最後の1つの横だけです。
複数の選択肢それぞれに記入欄を付けたい場合は、別のフォームタグを足すか、条件分岐で入力欄を出し分ける方法になります。
「その他」を選んでいないのに、自由記入欄の文字がメールに混ざります。
6.2.3 の仕様どおりの挙動です。
送信値を作る処理は「その他が選ばれたか」を見ておらず、送信された選択値の配列の最後の要素に、自由記入欄の文字をスペースでつなぎます。
そのため別の選択肢だけを選んだ人が記入欄に文字を入れると、その選択肢に文字が連結されます。
自由記入欄を必須にできますか。
標準ではできません。
必須の判定は選択肢の側にしか働かず、記入欄が空のままでも送信できます。wpcf7_validate_checkbox* と wpcf7_validate_radio のフィルターで、最後の選択肢が選ばれているのに記入欄が空なら弾く処理を自分で足します。
自由記入欄の内容だけを、メールの別の行に出せますか。
出せません。
自由記入欄のname属性は _wpcf7_free_text_ で始まり、Contact Form 7 は送信データを組み立てる時点でアンダースコア始まりのキーをすべて除外します。
メール本文にそのタグを書いても置換されず、タグの文字列がそのまま出ます。