Mail Form

Mail Form Ver.1.21 Manual


感謝您下載Mail Form。
以下記載本程式的設置及設定方法。

另外若沒有HTML的相關知識就無法使用本程式。
HTML的介紹網站相當的多,請不懂的朋友先自行參考學習。


目錄

0. 關於壓縮檔

1. 設置與設定

2. 錯誤訊息表單、寄信成功表單

3. 寄信內容輸入表單

4. 寄信確認表單



0. 關於壓縮檔 △回最上面

解開mailform.zip會得到以下的檔案。
請確認所有的檔案都在其中。

check.html--寄信確認表單
complete.html--寄信成功表單
error.html--錯誤訊息表單
form.html--寄信內容輸入表單
form.txt--只記載 form.html 重要部份的檔案,用於說明設定內容
mail.cgi--寄信CGI
manual.html--說明檔,目前您所看的檔案。
tempfile.dat--暫存用檔。


1.設置與設定 △回最上面

首先是設定。
以文書編輯軟體開啟mail.cgi,確定perl的執行路徑。
除此之外還有一些要設定的部份,
大部份都是一目了然,難懂的部份在檔案中也有簡單的說明。
因此在這裡先行省略。

以下示範基本的設置方法。
/ 代表資料夾,()的數值代表權限。

/mailform(755) --+-- mail.cgi (755)
                 |
                 +-- tempfile.dat (666)
                 |
                 +-- form.html(644)
                 |
                 +-- error.html(644)
                 |
                 +-- check.html(644)
                 |
                 +-- complete.html(644)

tempfile.dat 用於檢驗是否為相同IP連續發信。
不使用本機能的話就不需要此檔案。

部份網頁空間無法正常顯示設置於CGI目錄中的HTML檔案。
在這種時候必須將form.html complete.html置於瀏覽器可以正常顯示的位址。
另外以下要說明的四個表單中,寄信內容輸入及確認的兩個表單使用了form的語法標籤。
這個部份請配合CGI網址路徑設定。



2.錯誤訊息表單、寄信成功表單 △回最上面

本寄信表單可以用HTML設定所有的顯示畫面。
需要的檔案共有四個,總之先從簡單的部份進行說明。
先檢視範例檔或許會比較容易理解。

首先是寄信成功表單(complete.html)。
各位看了就知道,只是單純的HTML。
完全沒有跟CGI相關的動作,請自由變更版面及內容。

接著是錯誤訊息表單(error.html)。
這裡與寄信確認表單使用了變數
使用變數之後,在實際顯示時會自動置換內容。

這裡所使用的只有<!--ERROR-->這一個變數,
這將會顯示錯誤訊息。
比方說沒有輸入姓名的話,<!--ERROR-->會被置換成「請輸入姓名。」



3.寄信內容輸入表單 △回最上面

這個部份是form.html的內容。從這裡開始會變得麻煩。
範本檔案在設計上把所有的標籤語法都放進去了,請參考 form.txt 。
裡頭列舉了 form.html 使用的標籤語法。

首先從基本元件開始說明。

總之先列舉出來。

<form method="post" action="./mail.cgi">

姓名
<input type="text" name="name" size=20>

E-Mail
<input type="text" name="mail" size=40>

URL
<input type="text" name="url" size=40>

主旨
<input type="text" name="title" size=40>

內文
<textarea name="message" cols=40 rows=10></textarea>

信件副本
<input type="radio" name="copymailcheck" value="1" checked>寄出
<input type="radio" name="copymailcheck" value="0">不寄出

<input type="submit" value="Check">
<input type="reset" value="Reset">

<input type="hidden" name="act" value="check">
</form>
首先是最上面及最下面的 form 標籤。這裡是宣告即將要送出資料。
若是 form.html 不在CGI資料夾內,請變更 action 指定的CGI路徑。

</form>上面一行寫有 name=act 的 input 標籤,請當作完成程式的咒文。
再往上的 input type="submit" 標籤是寄信按鍵。
input type="reset" 是重設用按鍵。

以上是無論如何都必備的標籤。
接下來的視情形可有可無。

請看姓名到內文之間的標籤。
這是輸入各種資料用的標籤。
只有在CGI中設定必須要輸入的狀況下,才需要使用這些標籤。

另外關於信件副本的選向。
只有在CGI中設定 $copymail = 0; 時,需要讓使用者自行選擇。



以下是擴充用內容。請務必置於 form 標籤之間。
可以自由寄送喜歡的內容。
以下從 form.txt 引用一個例子。
<input type="hidden" name="datatitle1" value="Question1">
<input type="hidden" name="datacheck1" value="1">
<input type="text" name="data1" size=10>
就像是這個樣子。
首先是最上面的 datatitle1 。這是這個資料的名稱。
接著是 datacheck1 。將 value 設為 1 的話,就表示一定要輸入或是選擇,沒有這個必要的話就設為 0 。
然後在最後作一個名為 data1 的輸入用表格。

想多幾個的話就設置 datatitle2、datacheck2 以及 data2 。
只需要增加位於最後的數字即可。
但請務必從 1 開始編號。
否則將無法正常動作。



4.寄信確認表單 △回最上面

使用的是 check.html
如果在CGI中設定無須確認直接寄出,就可以忽略這個檔案。

<form method="post" action="./mail.cgi">
<input type="submit" value="寄出">
<input type="hidden" name="act" value="send">
<!--ALLDATA-->
</form>
總之是用來寄信的按鈕。不設定就無法寄信。
在範本中位於最下方。

順帶一提:
<form method="post" action="./mail.cgi">
<input type="submit" value="返回">
</form>
這可以讓使用者返回寄信內容輸入表單。
其實放個回到 form.html 的連結就可以了,想要讓版面統一的話建議使用。

之後是變數。以下列出變數及其內容。

<!--NAME-->--姓名
<!--MAIL-->--E-mail
<!--URL-->--URL
<!--TITLE-->--主旨
<!--MESSAGE-->--內文
<!--COPYMAIL-->--是否寄出副本
<!--DATA1-->--在 data1 輸入畫面中輸入或選擇的內容
<!--DATA2-->--在 data1 輸入畫面中輸入或選擇的內容。data3以後也相同。。

請組合這些表單用標籤,為版面進行適當的設計。




2001/04/19 Ver.1.21
2000/12/30 Ver.1.20


The Room