WebRefer 使用手冊
An embeded email client for web page referral, (C)Copyright 2005-2006 v1.1, Saintus Inc.

這份使用手冊僅針對網頁設計人員在編輯網頁時，該如何將WebRefer的功能加入網頁， 文件中並沒有包含該如何調整與設定WebRefer在伺服器端的程式的方法。 假如需要進一步瞭解WebRefer在伺服器端的安裝與管理，請參閱「WebRefer管理手冊」。

WebRefer簡介

WebRefer是一套工具程式，可以讓訪客將喜歡的網頁，直接在線上透過瀏覽器以email寄給其他的朋友。

WebRefer包含兩個部分，一個是放在網頁上的轉寄程式，另一個是server端的WebRefer主程式。

要能讓訪客將喜歡的網頁轉寄出去，您必須在要提供此功能的網頁上，都加上前述的轉寄程式， 並且要有能提供服務的WebRefer Server。這份文件將說明轉寄程式的安裝與使用， 對象是針對網頁製作人員而編寫，至於如何安裝與設定WebRefer Server則不在這份文件的說明範圍內。

您可以向您的主機管理人員確認，只要WebRefer Server已經上線並設定妥當， 您就可以直接依照這份文件所說的方式，在網頁裡面安裝轉寄程式， 而不用擔心WebRefer Server的設定狀況。

WebRefer運作流程說明

當WebRefer轉寄程式被安裝在要提供轉寄功能的網頁上面時，網頁上會出現一個這樣的小圖示 「」。

當使用者，點選這個小圖示之後，會出現類似如右的轉寄畫面：

這個畫面裡面的內容不見得會和你的一樣，裡面會有哪些項目可供選擇， 是安裝轉寄程式的時候可以設定的。

目前您看到的這個畫面是「標準模式」。

隨著你的設定不同，你也可能看到的是類似這樣的畫面，有很多的功能可以選。 以右邊看到的這個畫面是「進階模式」。

在進階模式中，所有的轉寄功能都會呈現出來，使用者可以輸入許多額外的資訊， 甚至可以將收件人與發件人的資訊記下來，如此一來下次若要轉寄其他 網頁給同一個人的時候，就可以不用重複輸入。

進階模式功能相當豐富，但是對於一般剛學會上網的訪客來說， 過多的選項反而容易讓人不知所措，因此要使用標準模式或進階模式， 可以由網頁設計人員自行斟酌。

標準模式與進階模式的這兩個畫面，都是由WebRefer Server所產生， 這兩個畫面並不是由網頁設計者安插轉寄程式的網頁所產生。

當使用者按下「送出」的按鈕之後，WebRefer Server就會將信由server端寄出， 若成功送出的話，則會看到如右的畫面。

因為垃圾信氾濫的關係，許多使用者都有安裝垃圾信的過濾軟體， 因此有時收件人不一定能收到經由WebRefer Server寄出的電子郵件， 假如某個收件人是您第一次轉寄網頁給他，而這個網頁又非常重要的話， 您最好於轉寄的郵件發出後，透過電話或其他方式確認對方是否有收到。

當出現成功畫面時，信件將會馬上被從WebRefer Server送出到收件人的信箱。

當收件人收到信的時候，他除了會完整看到被轉寄的網頁外，郵件的前端還會加上一段附加說明， 說明這個網頁的原始URL來在網路上的何處，以及是誰轉寄的以及發件者當時附加的說明

我們稱轉寄的網頁前面的這段訊息叫做「引言」(preface)， 這段文字的內容是由網頁設計人員預先準備好的，幾如您沒有準備專屬的內容， 您也可以使用WebRefer預設的內容 (圖中所示的就是預設的內容)。

如何將WebRefer套用至網頁上

將WebRefer的轉寄程式套用到網頁上的方法很簡單，您只需要把這一段HTML碼， 加入到要轉寄的網頁裡面即可。

至於該加入網頁的什麼地方呢？因為加入該段HTML會在網頁上產生前面提到過的 小圖示「」，所以請將該段HTML碼安插到，希望該圖示在網頁上出現的地方。

在您安插該段HTML碼前，請留意該HTML碼前面幾行的內容，這幾行表示了該如何設定您的轉寄程式： 

show_comment = 0;
show_subject = 1;
mode_button = 1;
def_mode = "basic";	// can be "basic" or "advanced"
use_page_title_as_subject = 1;
def_subject = "";
def_comment = "";
def_preface = ""; 
language = "big5"	// can be "big5", "gb", or "eng"
send_content = 0;
以下將針對這些設定稍做說明，您可以使用文書編輯器(例如Windows內建的記事本)來編輯這些設定的值：
變數名稱用途可輸入的值
show_comment 是否顯示讓使用者輸入附加說明的文字框。假如不顯示的話，則使用者無法更改附加說明的內容 0或1
show_subject 是否顯示讓使用者輸入郵件標題的欄位。假如不顯示的話，則使用者無法更改郵件標題 0或1
mode_button 是否顯示切換標準模式與進階模式的連結。不顯示的話，使用者無法在兩種模式間切換 0或1
def_mode 要以何種模式開啟轉寄功能的畫面 ("basic":標準模式，"advance":進階模式) basic或advance
use_page_title_as_subject 是否直接以該網頁的標題當作郵件的標題。 假如您的網頁沒有標題，而這個功能又開啟的話，那WebRefer會自動以預設的標題代替 0或1
def_subject 預設的郵件標題。假如use_page_title_as_subject=1的話，則這個項目無效 可輸入一段純文字，但不得帶有單引號或雙引號
def_comment 預設的附加說明。 可輸入一段文字，這段文字可以是純文字或HTML，但長度請勿超過100字
def_preface 預設的附加說明。假如不輸入的話，則直接使用WebRefer預設的附加說明 輸入一段URL，以該URL所指的網頁作為您要使用的附加說明
language 轉寄畫面的語言。 注意，這裡指的是輸入轉寄資訊的網頁所使用的語言，而不是您要轉寄的網頁內容的語言。 目前支援繁體中文、簡體中文與英文兩種網頁 "big5"、"gb"或"en"
send_content 是否要連網頁的內容一併轉寄出去。 假如選擇要的話，網頁內容會被連帶放在email裡面，直接寄給收信人。 假如選擇不要的話，只有網頁連結戶被放在email裡面寄出去。 0或1
(上面所有的設定中，0表示的是NO，1表示的是YES)

任何網頁都可以使用WebRefer來轉寄嗎？

可以被轉寄的網頁是那些可以被公開在網路上瀏覽的網頁，WebRefer Server在收到您的轉寄要求後， 會連上網路去把指定轉寄的網頁抓回來，放入email裡面寄給收件者，假如該指定的網頁 無法從網路上取得，那麼那種網頁就無法被透過WebRefer轉寄。

絕大多數的網頁都符合這個條件，只有極少數的網頁不行，那些不能被WebRefer Server所轉寄的網頁 通常都是瀏覽時需要輸入帳號密碼的，對於那些網頁，即使上面安裝了WebRefer的轉寄程式， WebRefer Server仍有可能無法轉寄該網頁。

還有一種網頁是網頁裡面有很多表格等輸入欄位的，因為WebRefer Server在抓取那些網頁時， 並無法代您輸入那些網頁上要求輸入的資料，所已有可能無法將網頁的內容正確取回。

此外，前面有提及，轉寄程式要能發揮功用，必須有與之互相配合的WebRefer Server事先被設定妥當， 假如WebRefer Server並沒有被設定妥當，仍然無法使用轉寄的功能

常見問題 (FAQ)

Q:什麼樣的瀏覽器可以使用WebRefer來轉寄網頁？
A:我們目前止試過IE，至於Firefox或Opera之類的瀏覽器仍尚未驗證，未來可能會支援

Q:IE瀏覽器使用上有什麼特別要注意的地方嗎？
A:請勿關閉JavaScript的功能，另外Cookie的功能也不能關閉。當然，最重要的是， 開啟新視窗的功能也不能關閉。

Q: 使用者回報看到這樣的訊息"Client xxx.xxx.xxx.xx is not registered."，這是什麼意思？
A: 這個使用者被系統管理員設定為，禁止使用WebRefer來轉寄網頁，請洽系統管理員。 (系統管理員可參考 conf/client.list的設定)

Q: 我是網頁設計者，我看到這樣的訊息"Servo xxx.xxx.xxx.xx is not registered."，這是什麼意思？
A:您所設計的網頁所屬的網站，被系統管理員設定為禁止使用WebRefer來轉寄貴網站的所有網頁， 請洽系統管理員。 (系統管理員可參考 conf/host.list的設定)

Q:假如我還有其他手冊尚未提及的問題，誰可以幫忙？
A:您可以透過這裡來反應遇到的問題