フィールドグループとリピーター
複数の項目を 1 組にまとめる フィールドグループ と、その組を行として繰り返す リピーター を追加します。「参加者を 5 人まで登録する」「ご希望の連絡方法を 1 組として扱う」といった入力ができます。
| フィールドタイプ | 内容 |
|---|---|
| フィールドグループ | 複数の項目を 1 組にまとめます。組は 1 つだけです |
| リピーター | 同じ項目の組を「行」として繰り返します。訪問者が行を追加・削除できます |
設定方法はどちらもほぼ同じで、リピーターには 行の設定 が加わります。組の中に入れる 項目を サブフィールド と呼びます。
グループ / リピーターを作る
- フォーム編集画面の 「フィールド設定」 タブで 「+ フィールドを追加」 をクリックします
- 「フィールドグループ」 または 「リピーター」 を選びます
- 「基本」 タブでフィールド名とラベルを入力します
- 「サブフィールド」 タブを開き、「+ サブフィールドを追加」 で組に入れる項目を追加します
- フォームを保存します
サブフィールドの一覧では、「編集」 で設定を展開し、「複製」「削除」、上下の矢印での並べ替えができます。
サブフィールドの設定
サブフィールドの設定項目は、選んだタイプによって変わります。
| 項目 | 内容 |
|---|---|
| 名前 | 保存やメール差し込みで使う識別子。組の中で重複しない名前にします |
| ラベル | 訪問者に表示される項目名 |
| タ イプ | 項目の種類 (後述) |
| 必須 | 入力を必須にします |
| プレースホルダー / 既定値 / 説明 / 選択肢 | 通常の項目と同じ設定です |
| 占める列数 | カラムレイアウトのとき、この項目が何列分の幅を使うか |
名前は 英字で始まり、英小文字・数字・アンダースコアだけ を使います。連続したアンダースコア (__) は使えません。また year month day part1 part2 part3 postal_code_part1 postal_code_part2 family given middle は内部で使う名前のため指定できません。使えない名前を入力すると、その場で警告が表示されます。
行の設定 (リピーターのみ)
| 項目 | 内容 |
|---|---|
| 最小行数 | 最初から表示しておく行数 (既定 0)。訪問者はこの数より行を減らせません |
| 最大行数 | 追加できる行数の上限 (既定 10・最大 100) |
| 行見出し | 「参加者 1」のように連番が付く見出しの語。未入力ならフィールドのラベルを使います |
| 追加ボタンの文言 | 行を追加するボタンのテキスト (既定は「行を追加」) |
訪問者は 「行を追加」 ボタンで行を増やし、各行の操作ボタンで削除・上下の移動ができます。最大行数に達すると追加ボタンが押せなくなります。
最小行数が 0 のままだと、フォームを開いたときに行が 1 つも表示されず、訪問者が「行を追加」を押すまで入力欄が現れません。最初から 1 行を見せたい場合は最小行数を 1 にしてください。
レイアウト
グループ・リピーターのどちらでも、組の並べ方を選べます。
| レイアウト | 表示 |
|---|---|
| 縦積み | 項目を上から順に並べます |
| カラム | 指定した列数 (1〜4) で横に並べます。各項目の「占める列数」で幅を変えられます |
| 表形式 | リピーター専用。1 行を表の 1 行として並べます。項目数が少ないときに向いています |
表形式は横幅を必要とします。項目が多いリピーターでは、カラムや縦積みのほうが読みやすくなります。
サブフィールドに使える項目の種類
使えるもの
- テキスト・複数行テキスト・メールアドレス・URL・数値・隠しフィールド
- 電話番号 (1 入力 / 分割入力)・郵便番号 (1 入力 / 分割入力)
- 日付 (カレンダー)・日付 (プルダウン)・時刻
- プルダウン・ラジオボタン・チェックボックス・都道府県 (単一選択 / 複数選択)
- 氏名 (パーツ別)・フリガナ (パーツ別)・住所
- ファイルアップロード
使えないもの
| 項目 | 理由 |
|---|---|
| フィールドグループ・リピーター | 入れ子には対応していません |
| 同意 (acceptance) | 同意はフォーム全体に 1 つあれば足りるため |
| パスワード | 行ごとに扱う用途がないため |
| HTML・ページ区切り・カスタムメールタグ | 入力項目ではないため |
- 郵便番号からの住所自動入力 は、グループ / リ ピーターの中では利用できません (設定欄も表示されません)
- サブフィールドには 文字数・パターンなどのカスタム検証ルール を設定できません
- URL パラメータからの初期値設定 は、組の中の項目には適用されません。ただし、既定値に
{post_title}などと書く 投稿の情報の自動取得 (?post_id=) は動作します
氏名・フリガナを必須にした場合、必須になるのは 姓と名 です (ミドルネームは任意)。住所を必須にした場合、建物名・住所 2・州 は任意のままです。これは無料版の同じ項目と同じ扱いです。
入力内容の保存と表示のされ方
| 出力先 | 表示 |
|---|---|
| 確認画面 | リピーターは行ごとに 1. 氏名: 山田 太郎 / メール: taro@example.com のように表示されます。グループは 連絡方法: メール / 時間帯: 午前, 夕方 のように表示されます |
| 通知メール | {all_fields} や {field:フィールド名} で、確認画面と同じ形のテキストが入ります (行ごとに改行) |
| CSV エクスポート | 1 つのフィールドが 1 つのセルに入り、行はセル内の改行で区切られます |
| 管理画面の送信詳細 | 行ごとに表示されます。ファイルはダウンロードリンクになります |
| Webhook | 組の構造をそのまま JSON で送ります。ファイルはファイル名に置き換わります |
氏名・住所は、表示のときに 1 つの値にまとめられます (例: 氏名: 山田 太郎、住所: 100-0001 東京都千代田区…)。
現行バージョンでは {field:親.サブ} のような書き方に対応していません。{field: 親フィールド名} で組全体を差し込んでください。
ファイルを組の中に入れる
サブフィールドに ファイルアップロード を入れると、行ごとにファイルを添付できます。最大ファイルサイズと許可する拡張子は、サブフィールドごとに設定します。
送信されたファイルは通常のファイル項目と同じように保存され、管理画面の送信詳細からダウンロードできます。
サーバーには一度に受け取れるファイル数の上限があります (PHP の max_file_uploads・既定 20)。「最大行数 × 行の中のファイル項目数」がこの上限を超える設定にすると、管理画面で警告が表示されます。警告が出たら、最大行数を減らすかファイル項目を減らしてください。
条件分岐との組み合わせ
グループ・リピーターには 条件分岐 を設定でき、組ごと表示 / 非表示 を切り替えられます。隠れている間は、組の中の入力はすべて送信されず、必須にしていても送信は止まりません。
一方、組の中の個々の項目に条件を付けたり、組の中の項目を条件の判定材料にしたりすることはできません。
HTML テンプレートを使っている場合
入力画面 HTML テンプレート では、[fplant_field name="members"] と書いた位置に組全体が出力されます。組の中の項目を 1 つずつ配置することはできません。
確認画面のカスタムテンプレートでは、[fplant_value name="members"] で組全体の内容が表示されます。
制限事項
- グループ / リピーターの入れ子 (組の中にさらに組を置くこと) には対応していません
- 組の中の個々の項目に条件分岐を設定すること、組の中の項目を条件の判定材料にすることはできません
- 組の中では郵便番号からの住所自動入力を利用できません
- 行はドラッグでは並べ替えられません (上下ボタンで移動できます)
- 同意 (acceptance) ・パスワードは組の中に置けません
{field:親.サブ}のようなサブフィールド単位のメール差し込みタグには対応していません- JavaScript 埋め込み (外部サイト向けスニペット) では動作しません。iframe 埋め込みでは動作します