フォームマニュアル｜Template Party CMS

フォームマニュアルManual

※近日中に、もう少しわかりやすいマニュアルに書き換えます。また、マニュアル通りでも動作しない場合があるかもしれません、その点も含め、マニュアルの更新をお待ち下さい。

「お問い合わせフォーム」に項目を追加・変更する方法。設定は /data/contact.json の fields 配列を編集して行います。管理画面の「フォーム設定（contact_settings.php）」は送信先や自動返信の設定用で、項目の追加・削除は対象外です。

基本ルール

編集ファイル	/data/contact.json をメモ帳等で開きます（UTF-8）。編集前に必ずバックアップを取ってください。
fields の1行	{ "key": "...", "type": "...", "label": "...", "required": true/false, "maxlength": 数字, "options": [ ... ] } 必要なキーだけを書けばOK（maxlength / options は任意）。
使える type	text … 1行テキスト textarea … 複数行テキスト email … メール形式チェックあり select … プルダウン（options を指定） radio … ラジオボタン（options を指定） checkbox … チェックボックス複数選択（options を指定）補足：「ラジオボタン（radio）」も使えます。
key の命名	英数・ハイフン・アンダーバーのみ。もしハイフンでNGならアンダーバーにしてみて下さい。
必須/文字数	required を true で必須、maxlength は text / textarea / email に有効。
選択肢	options は ["値1","値2","値3"] のように文字の配列で指定（select / radio / checkbox 用）。

よくある追加例

1) 会社名（text）を追加する

contact.json の fields に1行足します。

追記例	{ "key": "COMPANY", "type": "text", "label": "会社名", "required": false, "maxlength": 100 }

2) お問い合わせ種別（radio）を追加する

単一選択の質問。options に並べた順に表示されます。

追記例	{ "key": "REASON", "type": "radio", "label": "お問い合わせ種別", "required": true, "options": ["見積もり", "採用", "その他"] }
ポイント	ラジオは1つだけ選択されます。required: true で未選択を防止。メール本文にはお問い合わせ種別: 見積もりのように出ます。

3) 連絡希望手段（checkbox）を追加する

複数選択の質問。選ばれた値がカンマ区切りでメール本文に入ります。

追記例	{ "key": "CONTACT_WAY", "type": "checkbox", "label": "連絡希望手段", "required": false, "options": ["メール", "電話", "オンライン"] }

4) ご予算（select）を追加する

追記例	{ "key": "BUDGET", "type": "select", "label": "ご予算", "required": false, "options": ["未定","〜10万円","10〜50万円","50万円以上"] }

5) 補足（textarea）を追加する

追記例	{ "key": "NOTE", "type": "textarea", "label": "補足", "required": false, "maxlength": 1000 }

保存と確認

/data/contact.json を保存。
公開ページの「お問い合わせ」セクション（contact_form.html を使っているページ）を表示。
追記した項目が出ていればOK。送信テストを実施し、メール本文に値が並ぶか確認。

エラー時の対処

フォームが出ない/崩れる	contact.json のカンマの付け忘れや引用符の閉じ忘れを確認。 key に記号が入っていないか（半角英数字と、-（ハイフン）と、_（アンダーバー）のみ）。
送信できない	管理画面の「フォーム設定」で送信先メール（to_email）が正しいか。短時間に繰り返し送ると制限で弾かれます（1時間あたり上限あり）。

注意点（必読）

radio / checkbox / select は必ず options を配列で： 文字列の配列（例：["A","B","C"]）。空配列だと項目は表示されません。
maxlength は text / textarea / email のみ有効： それ以外に付けても無視されます。
HTMLは不要： contact.json にタグは書きません（危険なので禁止）。装飾はテンプレート側で。
項目名（label）は短く： 長すぎるとレイアウトが崩れることがあります。
確認メールの文面： 管理画面の「フォーム設定」で ヘッダー/フッター文を調整できます（自動返信ON時）。

実際の編集イメージ

最小例（既定3項目＋会社名＋種別ラジオ）

fields 全体例	[ {"key":"name","type":"text","label":"お名前","required":true}, {"key":"email","type":"email","label":"メール","required":true,"maxlength":200}, {"key":"message","type":"textarea","label":"お問い合わせ内容","required":true,"maxlength":2000}, {"key":"COMPANY","type":"text","label":"会社名","required":false,"maxlength":100}, {"key":"REASON","type":"radio","label":"お問い合わせ種別","required":true,"options":["見積もり","採用","その他"]} ]

fields 全体例

[ {"key":"name","type":"text","label":"お名前","required":true}, {"key":"email","type":"email","label":"メール","required":true,"maxlength":200}, {"key":"message","type":"textarea","label":"お問い合わせ内容","required":true,"maxlength":2000}, {"key":"COMPANY","type":"text","label":"会社名","required":false,"maxlength":100}, {"key":"REASON","type":"radio","label":"お問い合わせ種別","required":true,"options":["見積もり","採用","その他"]} ]

補足：テンプレ側は自動で反映

このCMSでは、contact_form.html を使っているページに、システムが {{CONTACT_FIELDS_HTML}} を自動注入します。fields を書き換えるだけで、テンプレートは基本そのままでOKです。

マニュアルメニューに戻る