Skip to content

テンプレートの記述方法

dounokouno edited this page Aug 10, 2012 · 80 revisions

テンプレートの記述方法

※上記をページ内リンクにしたいんだけど、どうすればいいの…。(tagawa)

入力画面(input.html)のフォームパーツ

シングルラインインプット

エラー画面の時、{$name値} に送信された値が出力されます。

<input type="text" name="お名前" value="{$お名前}" />

マルチラインインプット

エラー画面の時、{$name値} に送信された値が出力されます。

<textarea name="お問い合わせ">{$お問い合わせ}</textarea>

ラジオボタン

エラー画面の時、{$checked.name値.value値}checked="checked" が出力されます。

初期状態で checked="checked" を出力したい場合は、{$checked.default} を記述します。

<input type="radio" name="性別" value="男性" {$checked.性別.男性} {$checked.default} />男性
<input type="radio" name="性別" value="女性" {$checked.性別.女性} />女性

チェックボックス

エラー画面の時、{$checked.name値.value値}checked="checked" が出力されます。

初期状態で checked="checked" を出力したい場合は、{$checked.default} を記述します。

チェックボックスは複数の選択ができるため、name値の最後に [] を記述します。

<input type="checkbox" name="お問い合わせ種別[]" value="資料請求" {$checked.お問い合わせ種別.資料請求} {$checked.default} />資料請求
<input type="checkbox" name="お問い合わせ種別[]" value="お見積もり" {$checked.お問い合わせ種別.お見積り} />お見積り

セレクトメニュー

エラー画面の時、{$selected.name値.value値}selected="selected" が出力されます。

初期状態で selected="selected" を出力したい場合は、{$selected.default} を記述します。

<select name="お返事方法">
  <option value="" {$selected.default}>お返事方法を選択してください</option>
  <option value="メール" {$selected.お返事方法.メール} />資料請求</option>
  <option value="電話" {$selected.お返事方法.電話} />電話</option>
</select>

複数選択可能なセレクトメニューの場合は、name値の最後に [] を記述します。

<select name="お返事方法[]" multiple="multiple">
  <option value="" {$selected.default}>お返事方法を選択してください</option>
  <option value="メール" {$selected.お返事方法.メール} />資料請求</option>
  <option value="電話" {$selected.お返事方法.電話} />電話</option>
</select>

入力画面の入力オプション

入力必須

<input type="text" name="入力必須" value="{$入力必須}" />
<input type="hidden" name="required[]" value="入力必須 "/>
{if:$required.入力必須}
{$required.入力必須}
{/if:$required.入力必須}

{$required.お名前} 部分にエラーメッセージが表示されます。

半角(ASCII)文字チェック

<input type="text" name="半角文字" value="{$半角文字}" />
<input type="hidden" name="hankaku[]" value="半角文字" />
{if:$hankaku.半角文字}
{$hankaku.半角文字}
{/if:$hankaku.半角文字}

※入力された全角英数字は半角英数字に変換されます。

入力可能文字列

!"#$%&'()*+-./0123456789:;<=>?@ABCDEFGHIJKLNMOPQRSTUVWXYZ[]^_`abcdefghijklnmopqrstuvwxyz{|}~

半角英数字チェック

<input type="text" name="半角英数字" value="{$半角英数字}" />
<input type="hidden" name="hankaku_eisu[]" value="半角英数字" />
{if:$hankaku_eisu.半角英数字}
{$hankaku_eisu.半角英数字}
{/if:$hankaku_eisu.半角英数字}

※入力された全角英数字は半角英数字に変換されます。

入力可能文字列

0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

半角英字チェック

<input type="text" name="半角英字" value="{$半角英字}" />
<input type="hidden" name="hankaku_eiji[]" value="半角英字" />
{if:$hankaku_eiji.半角英字}
{$hankaku_eiji.半角英字}
{/if:$hankaku_eiji.半角英字}

※入力された全角英字は半角英字に変換されます。

入力可能文字列

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

数字チェック

<input type="text" name="半角数字" value="{$半角数字}" />
<input type="hidden" name="num[]" value="半角数字" />
{if:$num.半角数字}
{$num.半角数字}
{/if:$num.半角数字}

※入力された全角数字は半角数字に変換されます。

数字+ハイフンチェック

<input type="text" name="数字+ハイフン" value="{$数字+ハイフン}" />
<input type="hidden" name="num_hyphen[]" value="数字+ハイフン" />
{if:$num_hyphen.数字+ハイフン}
{$num_hyphen.数字+ハイフン}
{/if:$num_hyphen.数字+ハイフン}

※入力された全角英数字は半角英数字に変換されます。

ひらがなチェック

<input type="text" name="ひらがな" value="{$ひらがな}" />
<input type="hidden" name="hiragana[]" value="ひらがな" />
{if:$hiragana.ひらがな}
{$hiragana.ひらがな}
{/if:$hiragana.ひらがな}

※入力されたカタカナはひらがなに変換されます。

全角カタカナチェック

<input type="text" name="全角カタカナ" value="{$全角カタカナ}" />
<input type="hidden" name="zenkaku_katakana[]" value="全角カタカナ" />
{if:$zenkaku_katakana.全角カタカナ}
{$zenkaku_katakana.全角カタカナ}
{/if:$zenkaku_katakana.全角カタカナ}

※入力されたひらがなは全角カタカナに変換されます。

半角カタカナチェック

<input type="text" name="半角カタカナ" value="{$半角カタカナ}" />
<input type="hidden" name="hankaku_katakana[]" value="半角カタカナ" />
{if:$hankaku_katakana.半角カタカナ}
{$hankaku_katakana.半角カタカナ}
{/if:$hankaku_katakana.半角カタカナ}

※入力されたひらがな、全角カタカナは半角カタカナに変換されます。

全角文字を含むかチェック

<input type="text" name="全角文字を含むか" value="{$全角文字を含むか}" />
<input type="hidden" name="zenkaku[]" value="全角文字を含むか" />
{if:$zenkaku.全角文字を含むか}
{$zenkaku.全角文字を含むか}
{/if:$zenkaku.全角文字を含むか}

全て全角文字チェック

<input type="text" name="全て全角文字" value="{$全て全角文字}" />
<input type="hidden" name="zenkaku_all[]" value="全て全角文字" />
{if:$zenkaku_all.全て全角文字}
{$zenkaku_all.全て全角文字}
{/if:$zenkaku_all.全て全角文字}

文字数チェック

1〜3文字の場合

<input type="text" name="年齢" value="{$年齢}" />
<input type="hidden" name="len[]" value="年齢 1-3" />
{if:$len.年齢}
{$len.年齢}
{/if:$len.年齢}

1文字以上の場合

<input type="text" name="年齢" value="{$年齢}" />
<input type="hidden" name="len[]" value="年齢 1-" />
{if:$len.年齢}
{$len.年齢}
{/if:$len.年齢}

3文字以下の場合

<input type="text" name="年齢" value="{$年齢}" />
<input type="hidden" name="len[]" value="年齢 -3" />
{if:$len.年齢}
{$len.年齢}
{/if:$len.年齢}

2文字固定の場合

<input type="text" name="年齢" value="{$年齢}" />
<input type="hidden" name="len[]" value="年齢 2-2" />
{if:$len.年齢}
{$len.年齢}
{/if:$len.年齢}

メールアドレス書式チェック

<input type="text" name="メールアドレス" value="{$メールアドレス}" />
<input type="hidden" name="email[]" value="メールアドレス" />
{if:$email.メールアドレス}
{$email.メールアドレス}
{/if:$email.メールアドレス}

※チェックは簡易的なものです。チェックに通ったメールアドレスの存在を保証するものではありません。

一致チェック

<input type="text" name="メールアドレス" value="{$メールアドレス}" />
<input type="text" name="メールアドレス確認" value="{$メールアドレス確認}" />
<input type="hidden" name="match[]" value="メールアドレス メールアドレス確認" />
{if:$match.メールアドレス}
{$match.メールアドレス}
{/if:$match.メールアドレス}

※3つ以上の一致には対応していません。

URLチェック

<input type="text" name="URL" value="{$URL}" class="middle" />
<input type="hidden" name="url[]" value="URL" />
{if:$url.URL}
{$url.URL}
{/if:$url.URL}

※チェックは簡易的なものです。チェックに通ったURLの存在を保証するものではありません。 ※日本語ドメイン等の全角文字を含むドメインには対応していません。

入力オプションの組み合わせ例

入力オプションは複数のチェックを組み合わせることが可能です。

郵便番号をチェックしたい場合

郵便番号として、「数値とハイフンを含む8文字」をチェックする

<input type="text" name="郵便番号" value="{$郵便番号}" class="narrow" />
<input type="hidden" name="num_hyphen[]" value="郵便番号" />
<input type="hidden" name="len[]" value="郵便番号 8" />
{if:$num_hyphen.郵便番号}
{$num_hyphen.郵便番号}
{/if:$num_hyphen.郵便番号}
{if:$len.郵便番号}
{$len.郵便番号}
{/if:$len.郵便番号}

統括エラーメッセージ

{if:$global_error_flag}
<p>入力に誤りがあります。</p>
  <ul>
  {loop:$global_error}
    <li>{$global_error[]}</li>
  {/loop:$global_error}
  </ul>
{/if:$global_error_flag}

確認画面(confirm.html)

出力方法には「ループ出力」と「個別出力」の2種類があります。

個別に表示内容を調整したい場合は、「個別出力」をご利用ください。

ループ出力

<table>
  {$loop:$params}
  <tr>
    <th>{$params[].key} </th>
    <td>{$params[].value.nl2br} 
      {$params[].hidden}</td>
  </tr>
  {/$loop:$params}
</table>

個別出力

<table>
  <tr>
    <th>{$会社名.key} </th>
    <td>{$会社名.value}</td>
  </tr>
  <tr>
    <th>{$お名前.key} </th>
    <td>{$お名前.value}</td>
  </tr>
  <tr>
    <th>{$メールアドレス.key} </th>
    <td>{$メールアドレス.value}</td>
  </tr>
  <tr>
    <th>{$お問い合わせ内容.key} </th>
    <td>{$お問い合わせ内容.value.nl2br}</td>
  </tr>
</table>

改行コードを <br /> に変換する場合(マルチラインインプットの確認画面等)は {$項目名.value.nl2br} とします。

入力画面に戻るボタンと送信するボタン

<form method="post" action="index.php">
  {$hiddens}
  <input type="hidden" name="page" value="input" />
  <input type="submit" value="入力画面に戻る" />
</form>
&nbsp;
<form method="post" action="index.php">
  {$hiddens}
  <input type="hidden" name="page" value="finish" />
  <input type="submit" value="送信する" />
</form>

form要素を display:inline; にすると、ボタンが横に並ぶかと思います。

送信メール本文(mail_body.txt)、自動返信メール本文(mail_auto_reply_body.txt)

出力方法には「ループ出力」と「個別出力」の2種類があります。

個別に表示内容を調整したい場合は、「個別出力」をご利用ください。

ループ出力

お問い合わせフォームよりメールが送信されました。
 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
{loop:$params}
{$params[].key} = {$params[].value}
{/loop:$params}
 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
IP : {$_SERVER.REMOTE_ADDR}
HOST : {$_SERVER.REMOTE_HOST}
USER_AGENT : {$_SERVER.HTTP_USER_AGENT}
 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

※上記は送信メールのサンプルです。

個別出力

{if:$会社名.value}{$会社名.value}
{/if:$会社名.value}{$お名前・ご担当者名.value} 様
 
お問い合わせいただき、ありがとうございます。
1〜2営業日以内に担当者よりご連絡さしあげます。
 
1週間以上経ってもお返事がない場合は、
お手数ですが下記アドレスよりお問い合わせくださいませ。
 
info@example.jp
 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
【お問い合わせ内容は下記の通りです】
 
{$会社名.key} = {$会社名.value}
{$お名前.key} = {$お名前.value}
{$メールアドレス.key} = {$メールアドレス.value}
 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

※上記は自動返信メールのサンプルです。

その他

GET値の表示

GET値を入力画面、確認画面、メール本文に表示できます。

index.php?example=xxx の場合

{$_GET.example}

GET値の値渡し

GET値で全角文字を渡す場合、URIエンコードするようにしてください。
URIエンコードしない状態の時、IE6で文字化けを確認しました。

index.php?example=GET値渡しテスト の場合

<script type="text/javascript">
// めんどいのでjQuery使って書きます
$(function(){
    var get = '?example=GET値渡しテスト';
    var href = $('#example').attr('href');
    $('#example').attr('href, href + encodeURI(get)');
});
</script>
<a href="index.php" id="example">メールフォーム</a>