極意(49)自動返信フォーム(HAIKバージョン)

HAIKで自動返信フォームを作成する場合、編集画面の「パーツ~パーツ例~自動返信フォーム」と辿れば、簡単な問合せフォームが作成できます。問合せフォームだったら、これ以上の操作は不要で事足りるのですが、それだけで済まないのが現実の世界です。

住所欄を追加したい、チェック項目を追加したい、ラジオボタンを追加したい等々の種々の要求がでてきます。それらの項目を旧QHMのマニュアルでは転送項目要素と呼んでいます。旧QHMのマニュアルには、それらの項目要素を自動生成する機能がありましたが、HAIKマニュアルにはそれらの記載がありません。

そして悪いことに、2017年3月末には旧QHMマニュアルが閲覧できなくなります。
そこで筆者のやるべきことが明らかになりました。即ち、旧QHMマニュアルに替わる資料を作成することです。これは自分のためでもありますし、HAIKユーザーのためにもなることと信じています。

転送項目要素とは?

旧QHMのマニュアルでは、以下の10項目を転送項目要素と定義しています。
即ち、規定項目の名前からカスタム項目のファイル添付までの10項目がメールフォームの転送項目要素として設定できる項目となります。

<引用>
[check]各種フォーム要素について
qformでは、以下の要素が使えます。

  • 既定の項目
    • 名前
    • メールアドレス
    • 住所
    • 都道府県
  • カスタム項目
    • テキスト入力
    • ラジオボックス
    • チェックボックス
    • セレクト
    • テキストエリア
    • ファイル添付 (v4.75移行)

項目要素の自動生成機能

旧QHMのマニュアルには、項目要素の自動生成機能のポップアップ画面(下図)がありました。
今回、3月末でこの画面が使えなくなるのです。これに替わる補助資料を作成することとします。
画像の説明


フルスペックのメールフォームです。

先ずは、前記の転送項目要素10項目の全てを設定したフルスペックのメールフォームを作成することから始めます。
以下のアコーディオンを開いてみて下さい。

上記のおまじないです(但し転送項目のみ

#qform(HAIKのメールフォーム,bootstrap,true){{
name=お名前,,
name_kana=お名前(フリガナ),フリガナ名を入力して下さい,
email=メールアドレス,確認用のメールアドレスを入力して下さい,confirm,確認用メールアドレス
address=ご住所,お住いのご住所を入力して下さい,0,千葉県
state=お住まいの地域,お住まいの地域を選択して下さい,千葉県
contract=利用規約,同意される場合、チェックしてください,利用規約サンプル
text=id01,1行テキスト,デフォルト値,補足説明,,10
check=id02,チェックボックス,CK1,補足説明,CK1,CK2,CK3,CK4,CK5,CK6
radio=id03,ラジオボタン,RB1,補足説明,RB1,RB2,RB3,RB4,RB5,RB6
select=id04,セレクト項目,SL1,補足説明,SL1,SL2,SL3,Sl4,SL5,SL6
memo=id05,テキストエリア,デフォルト値,補足説明,,5
attach=id06,ファイル添付,補足説明,,2

・・・・・・・以降のソースコードは省略します。


転送項目のオプションについてのまとめ

  1. このページの利用方法ですが、要はコピペの元ネタと考えて下さい。
  2. ソースコードをコピーしてご自分のメールフォーム上に張り付けて使うことを前提としています。
  3. 見出し直下の一行目はオプションの一般型を表しています。
  4. 二行目から各オプション毎のソースコードで実際にはコチラをコピー対象にしてコピペして下さい。
  5. コピペの際、メールフォーム内で id番号が重複しないように変更して下さい。
  6. 補足説明は、各項目にあった文言に変更して下さい。

既定の項目

名前 [作成支援]オプションタイプ
name=ラベル,補足説明,必須チェック書式一般型
name=お名前,補足説明,姓名必要
name=お名前,補足説明,lname姓のみ必須
name=お名前,補足説明,fname名前のみ必須


名前(フリガナ) [作成支援]オプションタイプ
name_kana=ラベル,補足説明,必須チェック書式一般型
name_kana=お名前(フリガナ),補足説明,必須ではない
name_kana=お名前(フリガナ),補足説明,need姓名必須
name_kana=お名前(フリガナ),補足説明,lname_kana姓のみ必須
name_kana=お名前(フリガナ),補足説明,fname_kana名のみ必須


メールアドレス(必ず必要) [作成支援]オプションタイプ
email=ラベル,補足説明,確認入力,確認用メールアドレス補足説明書式一般型
email=メールアドレス,補足説明,,確認入力OFF
email=メールアドレス,補足説明,confirm,確認用メルアドの入力欄確認入力ON


住所 [作成支援]オプションタイプ
address=ラベル,補足説明,必須レベル書式一般型
address=ご住所,補足説明,,千葉県必須チェック:全て
address=ご住所,補足説明,0,千葉県必須チェック:なし
address=ご住所,補足説明,1,千葉県必須チェック:郵便番号
address=ご住所,補足説明,2,千葉県必須チェック:都道府県
address=ご住所,補足説明,3,千葉県必須チェック:市区町村
address=ご住所,補足説明,4,千葉県必須チェック:番地建物


都道府県選択 [作成支援]オプションタイプ
state=ラベル,補足説明,デフォルト書式一般型
state=お住まいの地域,補足説明,千葉県デフォルト:千葉県
state=お住まいの地域,補足説明,東京都デフォルト:東京都


利用規約 [作成支援]オプションタイプ
contract=ラベル,チェックボックスラベル,利用規約ページ名書式一般型
contract=利用規約,同意される場合、チェックしてください,ページ名利用規約ページ名を指定


カスタム項目

テキスト(1行) [作成支援]オプションタイプ
text=id,ラベル,デフォルト値,補足説明,必須チェック書式一般型
text=id01,1行テキスト,デフォルト値,補足説明,,10必須条件:特になし
text=id01,1行テキスト,デフォルト値,補足説明,need,20必須条件:必須
text=id01,1行テキスト,デフォルト値,補足説明,en,30必須条件:英数半角のみ
text=id01,1行テキスト,デフォルト値,補足説明,num,40必須条件:数字のみ


チェックボックス 複数選択可能 [作成支援]オプションタイプ
check=id,ラベル,デフォルト,補足説明,項目1,項目2,...書式一般型
check=id02,チェックボックス,CK1,補足説明,CK1,CK2,CK3,CK4,CK5,CK6デフォルト有り
check=id02,チェックボックス,,補足説明,CK1,CK2,CK3,CK4,CK5,CK6デフォルト無し


ラジオボタン [作成支援]オプションタイプ
radio=id,ラベル,デフォルト,補足説明,項目1,項目2,項目3...書式一般型
radio=id,ラベル,デフォルト,補足説明,項目1,項目2,項目3...,show:block縦並び型
radio=id03,ラジオボタン,RB1,補足説明,RB1,RB2,RB3,RB4,RB5,RB6横並び型
radio=id03,ラジオボタン,RB1,補足説明,RB1,RB2,RB3,RB4,show:block縦並び型


セレクトボタン [作成支援]オプションタイプ
select=id,ラベル,デフォルト,補足説明,項目1,項目2,項目3...書式一般型
select=id04,セレクト項目,SL1,補足説明,SL1,SL2,SL3,Sl4,SL5,SL6デフォルト有り
select=id04,セレクト項目,,補足説明,SL1,SL2,SL3,Sl4,SL5,SL6デフォルト無し


テキストエリア(メモ) [作成支援]オプションタイプ
memo=ID,ラベル,デフォルト,補足説明,必須チェック,行数書式一般型
memo=id05,テキストエリア,デフォルト値,補足説明,,5必須条件:特になし
memo=id05,テキストエリア,デフォルト値,補足説明,need,6必須条件:必須
memo=id05,テキストエリア,デフォルト値,補足説明,en,7必須条件:英数半角のみ
memo=id05,テキストエリア,デフォルト値,補足説明,num,8必須条件:数字のみ


ファイル添付 [作成支援]オプションタイプ
attach=ID,ラベル,補足説明,必須チェック,ファイルサイズ上限書式一般型
attach=id06,ファイル添付,補足説明,,2必須条件:特になし
attach=id06,ファイル添付,補足説明,need,3必須条件:必須

フォーム設定情報

自動返信メール、通知メール、完了ページの内容は、ユーザーが入力した情報で差し替えることができます。

特別項目 name姓<%lname%>
名 <%fname%>
特別項目 address住所 <%address%>
【個別】
郵便番号 <%address_zip%>
都道府県 <%address_state%>
市町村区 <%address_city%>
番地建物 <%address_street%>
特別項目 email<%email%>
特別項目 state<%state%>
カスタム項目 id
(※text=id,ラベル,....)
<%id%>
すべての投稿データ<%all_post_data%>
フォームのURL<%form_url%>


ご意見箱