Tech
Contact Form 7の受付期間|
日時で自動的に締め切る
セミナーやキャンペーンの申込を、開始日時と終了日時で自動的に開け閉めする方法です。
6.2.4.1の配布zipを実読し、期間の設定が存在しないこと、判定が9時間ずれる原因、表示を隠してもエンドポイントが開いたままになる仕組みまで示します。
セミナーの申込、キャンペーンの応募、採用エントリー。
「この日時から、この日時まで」だけ受け付けたいフォームは、受託の現場でかなりの頻度で出てきます。
依頼としては一行です。
ところが Contact Form 7 で実装すると、判定の置き場所が2か所あり、時刻の解釈でずれ、キャッシュで遅れ、さらに表示を消しても送信が通る、という順番で引っかかります。
この記事は、その4点を実際のコードで確認しながら潰していきます。
確認に使ったのは、WordPress.org から取得した最新安定版 contact-form-7.6.2.4.1.zip(414,335バイト・md5 df9fd5571996b7007471852a8f2cd36c・260エントリ・展開後 1,289,390バイト)です。
コードの実行は PHP 8.3.6 で行いました。
配布zipを読んでも、受付期間の設定はありません
まず、プラグイン側に期間という概念があるかどうかを先に確定させます。
zip内のPHP全ファイルを対象に、それらしい語を検索しました。
| 検索語 | 一致したファイル数 |
|---|---|
schedule | 0 |
start_date | 0 |
end_date | 0 |
expire | 0 |
deadline | 0 |
5語すべて0件です。
フォームタグにも、フォームの設定画面のタブにも、期間を保存する場所がありません。
つまり「開始日時」「終了日時」は自分で持ち、自分で比較する以外に方法がありません。
これは件数の上限と同じ構造です。
定員で締め切る側は受付件数に上限をつけて定員で締切るで書いたので、この記事は日時側に絞ります。
判定は1か所に書いて、表示と送信の両方から呼びます
実装でいちばん壊れやすいのは、表示側と送信側に別々の判定を書いてしまうことです。
片方だけ直して、もう片方が古い日時のまま残ります。
先に判定関数を1つ作り、両方からこれを呼ぶ形にします。
// 受付期間の状態を返す。
// 戻り値: 'before'(開始前) / 'open'(受付中) / 'closed'(終了後)
function fl_form_window( $form_id ) {
// フォームID => array( 開始日時, 終了日時 )。null は制限なし
$windows = array(
12 => array( '2026-11-04 10:00', '2026-11-18 18:00' ),
37 => array( null, '2026-12-01 23:59:59' ),
);
if ( ! isset( $windows[ $form_id ] ) ) {
return 'open';
}
list( $from, $to ) = $windows[ $form_id ];
// サイトのタイムゾーンで「今」を取る(WordPress 5.3以降)
$now = current_datetime();
if ( $from !== null ) {
$start = new DateTimeImmutable( $from, wp_timezone() );
if ( $now < $start ) {
return 'before';
}
}
if ( $to !== null ) {
$end = new DateTimeImmutable( $to, wp_timezone() );
if ( $now > $end ) {
return 'closed';
}
}
return 'open';
}
ポイントは2つです。
日時の文字列は必ず第2引数に wp_timezone() を渡して解釈すること、「今」は current_datetime() で取ること。
理由は次の節です。
なお、期間をコードに直書きするのは最初の一歩としては妥当ですが、運用に乗せるなら管理画面から変えられる形にします。
後半で、フォームごとに期間を持たせる方法を書きます。
9時間ずれる原因は、PHPの既定タイムゾーンがUTCであることです
WordPressは本体の読み込み時にPHPの既定タイムゾーンをUTCへ固定します。
この状態で日時の文字列を素のまま strtotime() に通すと、日本時間として書いた文字列がUTCとして解釈されます。
PHP 8.3.6 で実際に測った値です。
php default tz : UTC
strtotime('2026-11-05 18:00') = 1793901600 (2026-11-05 18:00 UTC)
new DateTimeImmutable('2026-11-05 18:00', 'Asia/Tokyo') = 1793869200 (2026-11-05 09:00 UTC = 18:00 JST)
差 = 32,400秒(9時間)
9時間の差が、そのまま締切のずれになります。
しかもずれ方は書き方の組み合わせで変わります。
「今」の取り方と「締切」の作り方を4通りで比較しました。
| 「今」 | 「締切」 | 結果 |
|---|---|---|
time() | DateTimeImmutable + wp_timezone() | 正しい |
time() | strtotime() | 9時間遅れて閉じる |
current_time('timestamp') | DateTimeImmutable + wp_timezone() | 9時間早く閉じる |
current_time('timestamp') | strtotime() | 偶然、正しく動く |
4行目が厄介です。
両方を同じ方向にずらすと誤差が打ち消され、結果だけ合います。
だから「動いているから正しい」と判断され、片方だけを後で直したときに9時間ずれが表に出ます。
既存サイトの改修で締切が合わないときは、この2つの関数がどちらも書き換わっているかを先に見てください。
もう1つ、日付だけを指定したときの落とし穴があります。
strtotime('2026-11-05') = 2026-11-05 00:00 UTC
new DateTimeImmutable('2026-11-05 23:59:59', 'Asia/Tokyo') = 2026-11-05 14:59:59 UTC
差 = 53,999秒(約15時間)
「11月5日まで受付」という指示を strtotime('2026-11-05') で受けると、11月5日が丸ごと受付できない状態になります。
日付までしか指定がない依頼は、その日の終わりまでなのか、その日の始まりまでなのかを必ず確認して、23:59:59 まで書いてください。
ちなみに Contact Form 7 自身は、時刻を扱う箇所で一貫して wp_timezone() と wp_date() を使っています。modules/date.php 74行、includes/form-tag.php 353行、includes/mail.php 653〜656行、includes/special-mail-tags.php 65〜69行、modules/flamingo.php 87行。
自前コードもこの基準に合わせておけば、メールに載る日時と締切の判定基準が食い違いません。
表示側:フォームを案内文に差し替えます
表示の差し替えは wpcf7_form_elements フィルタです。
適用位置は includes/contact-form.php 961行で、form_elements() が入力欄のHTMLを組み立てた直後に通ります。
add_filter( 'wpcf7_form_elements', function ( $content ) {
$contact_form = WPCF7_ContactForm::get_current();
if ( ! $contact_form ) {
return $content;
}
switch ( fl_form_window( (int) $contact_form->id() ) ) {
case 'before':
return '<p class="form-window form-window--before">受付開始は11月4日10時です。開始までお待ちください。</p>';
case 'closed':
return '<p class="form-window form-window--closed">受付を終了しました。次回の日程は決まり次第、本ページでお知らせします。</p>';
}
return $content;
} );
ここで知っておきたいのは、差し替わるのは入力欄だけということです。form_html()(同ファイル524行)が外側を組むため、<div class="wpcf7">、スクリーンリーダー用の応答領域、<form> タグ、CF7の隠しフィールドは残ります。
見た目は案内文だけになりますが、HTMLとしてはフォームが存在したままです。
開始前と終了後で文面を分けるのは、地味ですが効果があります。
「終了しました」しか出さないと、開始前に来た人も終わったと思って離脱します。
送信側:wpcf7_before_send_mail で止めます
送信を止められるのは wpcf7_before_send_mail です。includes/submission.php 712行で、第2引数が参照渡しになっています。
add_action( 'wpcf7_before_send_mail', function ( $contact_form, &$abort, $submission ) {
$state = fl_form_window( (int) $contact_form->id() );
if ( 'open' === $state ) {
return;
}
$abort = true;
$submission->set_response( 'before' === $state
? '受付開始前のため送信できませんでした。11月4日10時以降にお試しください。'
: '受付期間が終了したため送信できませんでした。お急ぎの場合はお電話でご連絡ください。'
);
}, 10, 3 );
set_response() を忘れないでください。
同ファイル112〜124行の処理を読むと、$abort が true で応答が空のとき、既定の文字列「Sending mail has been aborted.」がそのまま表示されます。
訪問者には何が起きたのか分かりません。
メッセージの差し替え全体の仕組みは送信メッセージとエラー文を変えるにまとめています。
実行順も押さえておきます。proceed()(84行)は、入力検証 → 同意チェック → スパム判定 → アップロードファイルの確定(828行の unship_uploaded_files())→ before_send_mail の順で進みます。
つまり締切後の送信でも、添付ファイルは一度サーバーの一時領域へ置かれます。
中断するだけで実害はありませんが、「締切後は何も起きない」わけではないことは知っておいてください。
受付期間つきのフォーム
自前で持つコードは、締切の判定だけに絞ってください
受付期間は標準にないので自分で書く必要があります。一方で、確認画面・送信内容のデータベース保存・CSV書き出し・自動返信まで自前で抱えると、保守する対象が一気に増えます。Frontierline Forms は確認画面、マルチステップ、送信内容のデータベース保存、送信履歴の一覧、CSV書き出しを無料版に含んだ Contact Form 7 用のプラグインです。申込が管理画面に全件残る状態を先に作っておくと、締切前後に何件入ったのかを後から数え直せます。
表示を隠しても、送信の入口は開いたままです
ここが、表示側だけで締め切ってはいけない理由です。
Contact Form 7 の送信は REST APIのルートで受け付けます。includes/rest-api.php 110行のルート定義はこうなっています。
'/contact-forms/(?P<id>\d+)/feedback',
array(
array(
'methods' => WP_REST_Server::CREATABLE,
'callback' => array( $this, 'create_feedback' ),
'permission_callback' => '__return_true',
),
)
permission_callback が __return_true です。
加えて、nonceの扱いも確認しておきます。includes/submission.php 698行です。
private function verify_nonce() {
if ( ! $this->contact_form->nonce_is_active() or ! is_user_logged_in() ) {
return true;
}
$nonce = wpcf7_superglobal_post( '_wpnonce' );
return wpcf7_verify_nonce( $nonce );
}
未ログインの訪問者は、nonceの検証を通らずに true が返ります。
これは誰でも送信できるフォームとして正しい設計ですが、結果として「フォームIDが分かれば、画面に入力欄が出ていなくてもPOSTは受理される」ことになります。
締切後に入力欄を隠しただけの実装では、過去にページを開いた人のブラウザからも、エンドポイントを直接叩く相手からも、メールが届き続けます。
表示側は親切のため、送信側は締切のため。
役割が別です。
両方入れてください。
フォームごとに受付期間を持たせます
期間をコードに直書きすると、日程変更のたびに開発側へ依頼が来ます。
運用するなら管理画面に置きます。
Contact Form 7 は、フォーム単位の設定項目を外から増やすための仕組みを持っています。
見本はプラグイン自身の中にあります。modules/sendinblue/contact-form-properties.php(586行)が、Brevo連携の設定をこの仕組みだけで実装しています。
使うフックは3つです。
// 1. フォームのプロパティに枠を作る
add_filter( 'wpcf7_pre_construct_contact_form_properties', function ( $properties, $contact_form ) {
$properties += array( 'fl_window' => array() );
return $properties;
}, 10, 2 );
// 2. 保存時に値を受け取る
add_action( 'wpcf7_save_contact_form', function ( $contact_form, $args, $context ) {
$prop = wp_parse_args(
(array) wpcf7_superglobal_post( 'fl-window', array() ),
array( 'from' => '', 'to' => '' )
);
$contact_form->set_properties( array( 'fl_window' => $prop ) );
}, 10, 3 );
// 3. フォーム編集画面にタブを足す
add_filter( 'wpcf7_editor_panels', function ( $panels ) {
$panels += array(
'fl-window-panel' => array(
'title' => '受付期間',
'callback' => function () {
$contact_form = WPCF7_ContactForm::get_current();
$prop = wp_parse_args(
$contact_form->prop( 'fl_window' ),
array( 'from' => '', 'to' => '' )
);
printf(
'<h2>受付期間</h2><p><label>開始 <input type="datetime-local" name="fl-window[from]" value="%s"></label></p>'
. '<p><label>終了 <input type="datetime-local" name="fl-window[to]" value="%s"></label></p>'
. '<p>空欄は制限なしとして扱います。サイトのタイムゾーンで判定します。</p>',
esc_attr( $prop['from'] ), esc_attr( $prop['to'] )
);
},
),
);
return $panels;
}, 10 );
あとは fl_form_window() の中で、配列の代わりに $contact_form->prop( 'fl_window' ) を読むように差し替えます。
これで日程の変更は、フォーム編集画面の「受付期間」タブで完結します。
datetime-local の値は 2026-11-04T10:00 のような形で入ってきます。DateTimeImmutable はこの形式も解釈できるので、変換は不要です。
キャッシュと、締切直後の申込の行方
残り2点、運用で必ず当たるものを書いておきます。
1つ目はページキャッシュです。
表示の差し替えはPHPが実行されたときに初めて効きます。
ページ全体がキャッシュされていると、締切後もしばらくは入力欄が出たページが配信されます。
遅れて見えるのは表示側だけで、送信は before_send_mail が止めるため事故にはなりませんが、訪問者から見ると「入力して送ったら、終了と言われた」という体験になります。
受付期間を持つページは、キャッシュの除外に入れておくのが無難です。
キャッシュ系プラグインとの相性はキャッシュでフォームが動かないときの切り分けに整理しています。
2つ目は、中断した申込が残らないことです。modules/flamingo.php が記録する対象は spam・mail_sent・mail_failed の3状態で、aborted は入っていません。
締切の1分後に届いた申込は、メールも来ず、記録も残りません。
キャンセル待ちの案内を出したい場合は、wpcf7_flamingo_submit_if に状態を足すか、送信内容をデータベースへ保存する仕組みを入れてください。
足し方は受付件数に上限をつけて定員で締切るに書いています。
確認の順番
受付期間を入れたあとは、この順で見ます。
- 開始前・受付中・終了後の3状態で、フォームのページを表示する(文面が切り替わるか)
- 終了後の状態で、ブラウザの開発者ツールから
/wp-json/contact-form-7/v1/contact-forms/<ID>/feedbackへPOSTする(メールが届かないか) - 終了後の送信で、画面に自分で書いたメッセージが出るか(「Sending mail has been aborted.」が出ていないか)
- サイトのタイムゾーン設定(設定→一般)が意図した地域になっているか
- 締切の1分前と1分後で、実際に境界が動くか
2番を飛ばさないでください。
ここが通ってしまう実装は、締切を設けた意味がありません。
関連するフックの全体像はContact Form 7のフックとフィルター一覧にまとめています。
Frontierline Forms
締切のある申込は、件数が見える状態で運用してください
受付期間を設けるフォームは、申込が集中する時間帯がはっきり出ます。メールだけが記録という状態では、締切前にどれだけ入ったのか、終了後に何件弾いたのかを後から数え直せません。Frontierline Forms は確認画面・マルチステップ・送信内容のデータベース保存・CSV書き出し・送信履歴の一覧を無料版に含み、有料版では保存期間の自動削除、個人情報の暗号化保存、自動返信の差出人と返信先の指定まで対応しています。次回の日程を決めるときの材料が、そのまま管理画面に残ります。
まとめ
Contact Form 7 に受付期間の設定はありません。
6.2.4.1 の配布zipを読んでも、期間を保持する場所がプラグイン側に存在しません。
実装は3層で考えます。
判定を1つの関数に寄せ、表示は wpcf7_form_elements で案内文に差し替え、送信は wpcf7_before_send_mail の $abort で止める。
判定の中では日時を wp_timezone() 付きで解釈し、「今」は current_datetime() で取ります。
いちばん多い失敗は2つです。
時刻の解釈が9時間ずれていること、そして表示を隠しただけでエンドポイントが開いたままになっていること。
どちらも画面を見ているだけでは気づけないので、締切後にエンドポイントへ直接POSTして確かめてください。
よくある質問
Contact Form 7に受付期間(公開期間)を設定する項目はありますか。
ありません。
6.2.4.1の配布zipに含まれるPHP全ファイルを対象に schedule・start_date・end_date・expire・deadline を検索しても一致が0件で、期間を保持する場所がプラグイン側に存在しません。
開始日時と終了日時は自分で持ち、表示側と送信側の両方で判定する実装になります。
締切の判定が9時間ずれるのはなぜですか。
WordPressがPHPの既定タイムゾーンをUTCに固定しているためです。strtotime('2026-11-05 18:00') はUTCの18時として解釈され、日本時間の18時を指す値より32,400秒(9時間)大きくなります。
日時の文字列は new DateTimeImmutable($str, wp_timezone()) で解釈してください。
フォームの表示を隠せば、締切後の送信は止まりますか。
止まりません。
送信の受け口は REST APIのルートで、6.2.4.1の rest-api.php 110行の feedback ルートは permission_callback が __return_true です。
さらに submission.php 698行の verify_nonce() は未ログインの訪問者に対して検証前に true を返します。
画面から入力欄を消しても、エンドポイントへ直接POSTされればメールは送られます。
締切後に送信を止めるフックはどれですか。
wpcf7_before_send_mail です。
第2引数の $abort を参照渡しで true にすると送信が中断され、状態が aborted になります。set_response() を併せて呼ばないと、訪問者には既定の「Sending mail has been aborted.」が表示されます。
締切で中断した申込は管理画面に残りますか。
既定では残りません。
FlamingoがCF7から記録する対象は spam・mail_sent・mail_failed の3状態だけで、aborted は含まれていません。
締切直後の申込を把握したい場合は wpcf7_flamingo_submit_if に状態を足すか、送信内容をデータベースへ保存するプラグインを使ってください。