1. このプログラムの構成
2. web page での設定
3. テンプレートファイルの設定
4. マクロ一覧
   
   
5. テンプレートファイルサンプル

このシステムは次の要素で構成されています。
(1) メール編集/送信スクリプト
(2) テンプレートファイル

• cgimail.pl

フォームを使った web page の入力項目を指定されたアドレスにメールで送信し、「送信されました」などの次のページを表示します。メールや次ページのスタイルはテンプレートファイルや web page フォーム内のHIDDEN タイプエレメントを使って自由にカスタマイズすることができます。
そのため、同じスクリプトを使っていろいろなページで形式の違うメール送信処理を行うことができます。

メールの送信先やアクション後に表示するページのスタイルを指定するファイルです。
ファイルの漢字コードを気にする必要はありません。
また、HTML ファイルでもテキストファイルでもかまいませんが、HTML ファイルにしておくとアクション後に表示するページをブラウザで表示して見た目をテストできるので便利です。 設定方法については後述をご覧ください。

web page では FORM 中で以下の項目を設定します。

a) ACTION

FORM タグの ACTION にスクリプト名を指定します。さらにスクリプト名の後にテンプレートファイルがおかれているディレクトリを URL パスで指定します。
METHOD は GET でも POST でもかまいません。

例：

<FORM ACTION="/cgi-bin/cgimail.pl/ksr" METHOD=POST>
後述するTMPLFILEを使用しない場合はスクリプト名の後の URL パスを指定する必要はありません。

b) TMPLFILE

FORM 中の HIDDEN タイプエレメントでマクロを設定したテンプレートファイルを指定します。

例：

<INPUT TYPE="hidden" NAME=" TMPLFILE " VALUE=" cgimail_tmpl.html ">

基本的にはこれでだけで十分ですが、一覧表にあげたマクロはすべて HIDDEN タイプエレメントで埋め込むこともできます。
後述の MLADDRESS マクロ を HIDDEN タイプエレメントに埋め込めば、テンプレートファイルを使用しなくてもメールを送信することができます。
テンプレートファイルを使用しない場合は ACTION でスクリプト名の後に記述するURL パスを指定する必要はありません。

ただし、マクロに複数行の文字列を指定したい場合はフォームの HIDDEN タイプエレメントは使用できませんので、テンプレートファイルのマクロブロック内で記述してください。

テンプレートファイルでは後述の各種マクロを以下の形式で記述します。
<!-- START_ MACRONAME -- *
マクロの設定値
* -- END_ MACRONAME -->

１つのマクロブロックは、行頭から <!-- START_MACRONAME -- と書かれた行から -- END_MACRONAME -->と書かれた行で囲まれた領域です。
* の部分には任意の文字列が入っていてもかまいません。

MLADDRESS マクロは、テンプレートファイルかフォームの HIDDEN タイプエレメントのどちらかで 必ず指定してください。
MLADDRESS マクロを記述しないとメールを送信することができません。

テンプレートファイルを HTML ファイルにするとき、NEXTPAGE マクロブロックを以下のように記述するとアクション後に表示される内容をブラウザで表示して確かめられるので便利です。
例：

設定できるマクロの一覧を表にしました。
表中の全てのマクロが web page のフォーム内の HIDDEN タイプエレメントで設定可能です。
ただし、NEXTPAGE マクロや MLHEAD, MLFOOT マクロなど、改行を含む複数行の文字列を使用したい場合は HIDDEN タイプエレメントでは指定できません。複数行の文字列を指定したい場合はテンプレートファイルのマクロブロックで記述してください。