メインコンテンツまでスキップ

フォーム設定

フォーム設定」タブでは、メール通知・確認画面・送信後アクションなどフォーム全体の挙動を設定します。見た目の調整は「デザイン」タブに分かれています (デザイン調整 を参照)。

メール設定

管理者通知メール

フォーム送信があった際、サイト運営者に届くメールです。

項目説明
送信先通知を受けるメールアドレス。複数指定可 (カンマ区切り)
件名メール件名。差し込みタグ利用可
本文メール本文。差し込みタグ利用可
From アドレス送信元アドレス。サイト固有のメールアドレス推奨
From 名送信者表示名
Reply-To返信先アドレス。送信者のメールアドレスを指定するのが一般的

自動返信メール

送信者本人 (フォームの「メールアドレス」フィールドの値) に届く確認メールです。

  • 送信先には メールアドレスフィールド の値が自動的に使われます
  • 件名・本文は管理者通知メールと同様に差し込みタグが使えます
  • 自動返信を 送信しない 設定も可能です

差し込みタグ

メール本文・件名で使用できる差し込み形式です。

{お名前} ← フィールド名「お名前」の入力値が入る
{メールアドレス} ← フィールド名「メールアドレス」の入力値が入る
{all} ← すべてのフィールドの入力内容を整形して挿入

確認画面

入力 → 確認画面 → 完了 のフローを切り替えられます。

設定動作
確認画面を表示する送信ボタンを押すと確認画面に遷移
確認画面を表示しない送信ボタンを押すと即送信

確認画面のレイアウトも、HTML テンプレートで自由にカスタマイズできます (詳細は HTML テンプレート)。

送信後アクション

送信完了時の挙動を 3 種から選択できます。

アクション用途
メッセージ表示フォーム上に「送信が完了しました」等のメッセージを表示 (デフォルト)
カスタム HTML任意の HTML / ショートコードを表示。サンクスメッセージや関連情報の案内に
リダイレクト指定 URL に自動遷移。サンクスページや外部 URL へ

デザイン設定

フォームの見た目は「デザイン」タブで設定します。プリセット選択に加えて、色・サイズ・余白などをライブプレビューを見ながら調整できる「デザイン調整」、カスタム CSS のアップロードが利用できます。

詳細は デザイン調整 を参照してください。

バリデーション設定

フィールド単位のカスタムエラーメッセージ設定に加え、フォーム全体の挙動として以下を設定できます。

  • エラーメッセージの表示位置 (フィールドごと / フォーム上部にまとめて表示)
  • エラー時のスクロール挙動

スパム対策

スパム対策は専用ページにまとめています。スパム対策 を参照してください。

URL パラメータでフィールド初期値を渡す

フォームの URL にクエリパラメータを付けるだけで、各フィールドの初期値をあらかじめ埋めた状態で表示できます。コードは不要です。

「イベント告知ページの『申し込む』ボタンから申込フォームへ遷移する際、どのイベントの申込かをフォーム側に引き継ぎたい」といったケースで便利です。

設定手順

  1. フォーム編集画面で、初期値を受け取りたいフィールド (テキスト・隠しフィールドなど) を用意し、フィールド名 を URL パラメータのキー名と同じにします (例: post_title)
  2. そのフィールドの デフォルト値{フィールド名} を入力します (例: {post_title})
  3. 「フォーム設定」タブの 「URL パラメータ設定」「URL パラメータからの初期値設定を許可」 にチェックを入れて保存します
3 つの名前を一致させてください

フィールド名デフォルト値の中括弧内URL パラメータ名 は、すべて同じ文字列にする必要があります (例: いずれも post_title)。中括弧内はフィールド自身の名前と一致したときだけ有効になる指定で、別のパラメータ名を参照する書き方ではありません。フィールド名と URL パラメータ名を変えたい場合は、後述の PHP フィルターを使ってください。なお、URL に ?post_id= を付けた場合に限り、フィールド名と一致しない {キー名} は次節の投稿情報として解決されます ( バージョン 1.4.1 以降 ) 。

これで次のような URL でフォームを開くと、post_title フィールドに「セミナー A」が初期値として入ります。

https://example.com/entryform/?post_title=セミナー A

複数のフィールドを同時に渡すこともできます。

https://example.com/entryform/?post_title=セミナー A&post_id=22155
隠しフィールドで送信データに残す

画面に表示せず、送信データ・通知メールにだけ含めたい場合は 隠しフィールド (hidden) を使い、同じ手順 (フィールド名=パラメータ名、デフォルト値={フィールド名}) を設定してください。

注意点

  • URL に載せた値は 利用者が書き換え可能 です。金額や権限など、改ざんされて困る値の受け渡しには使わないでください。
  • 日本語などの値を URL に含める場合は URL エンコード が必要です。リンク元ページ側で urlencode() 等を通して出力してください。
  • 値は フィールドの型に応じてサニタイズ されます (メール型はメール形式、URL 型は URL 形式、数値型は数値のみ、など)。

投稿の情報を自動取得する ( ?post_id= )

バージョン 1.4.1 から、URL には 投稿 ID だけ を渡し、タイトルやカスタムフィールドの値は投稿データから自動で取得できます。値そのものを URL に載せないため利用者に書き換えられず、投稿タイトルの変更にも自動で追従します ( MW WP Form の「URL 引数を有効にする」に相当する機能です ) 。

  1. フィールドの デフォルト値 に、取得したい項目を {キー名} で入力します ( フィールド名は自由です )
  2. 「URL パラメータからの初期値設定を許可」 にチェックを入れて保存します ( 前述の設定と共通 )
  3. フォームページへのリンクに ?post_id=投稿ID を付けます
https://example.com/entryform/?post_id=22155

{キー名} として使える値は次のとおりです。

書き方取得される値
{post_title}投稿タイトル
{ID}投稿 ID
{post_name}スラッグ
{post_date}投稿日時
{post_excerpt}抜粋
{post_content}本文
上記以外の {任意のキー}カスタムフィールド ( 投稿メタ ) の値

たとえばセミナー詳細ページの「申し込む」リンクを ?post_id=セミナー投稿の ID にし、フォーム側で「セミナー名」フィールドのデフォルト値を {post_title}、隠しフィールドのデフォルト値を {ID} にすると、申込フォームにセミナー名と投稿 ID が自動で入ります。

取得できる範囲 ( セキュリティ )
  • 取得できるのは 公開されている投稿・固定ページのみ です。下書き・非公開・パスワード保護された投稿からは取得されません
  • キー名がアンダースコア _ で始まる 保護されたカスタムフィールドは取得されません
  • 取得できない場合 ( 非公開の投稿 ID や存在しないキーを指定した場合など ) は、初期値は になります ( {キー名} がそのまま表示されることはありません )

バージョン 1.4.0 以前でこれを実現したい場合は、PHP フィルター fplant_field_initial_value_{name} を使ってください ( PHP フック 参照 ) 。

サイト外での利用

iframe / JavaScript で外部サイトに埋め込む場合の設定。外部サイトでの利用 を参照してください。

エクスポート / インポート

フォーム設定一式を JSON でエクスポート / インポートできます。

  • エクスポート — フォーム編集画面の「設定」メニューから現在の設定を JSON でダウンロード
  • インポート — フォーム新規作成時に JSON をアップロードして復元

ステージング環境から本番環境への移行や、設定のバックアップに利用できます。