I-BOARD/LR 中文說明書

I-BOARD/LR

一行回覆圖圖留言板 (中文版)

■ 功能介紹

支援圖檔選擇及管理者專用圖檔
應用COOKIE技術，記錄欄位資訊
可輕鬆刪除及編輯留言，管理者以萬用密碼進入線上管理模式，留言記錄一目了然，可進行批次式的刪除動作
內置計數器功能，可使用圖檔顯示
可設定HTML語法允許使用與否，使用者可貼圖貼連結
寄發郵件通知功能，讓你只須檢查郵箱即可得知板上最新寫入的記事內容（只適用於支援sendmail使用的主機伺服器）
圖檔亂數選取功能
多重回覆功能（只限一行回覆）
使用者管理功能，可刪除及編輯留言
記錄IP位址．方便追蹤來源；可設定禁止某些位址進行寫入動作
簡單的舊留言集保存功能
留言記錄備份功能

■ 使用條款

歡迎免費使用這個CGI程式，但不得以任何方式作為商業用途。
你可依個人喜好修改原程式碼，惟關於著作權資訊的部份不得刪除。
假如因為使用這個程式而引致你有任何損失，原作者及中文化作者一概不負有關責任。

■ 檔案檢查

請檢查一下程式壓縮包，解開後應包括下列檔案：

ibbsr.cgi - 主程式檔
rsrch.cgi - 附屬程式檔 - 搜尋留言/翻閱舊留言集專用
ibbsr.dat - 主記錄檔
irc.dat - 內置計數器數值記錄檔
rlog.log - 舊留言集數值記錄檔
irbup.bak - 備份檔案
ibbsr.htm - HTML格式中文詳細說明書(即本檔)
readme.txt - 中文讀我檔案
[icon] - 子資料夾(存放範例留言圖檔)
[img] - 子資料夾(存放範例程式圖檔)

■ 修改設定

以下是使用這個程式之前必須先修改的最基本設定值。請利用你最常用的純文字編輯器打開主程式檔「ibbsr.cgi」進行下列修改程序。

第1行

#!/usr/local/bin/perl

這是perl編繹器程式在執行主機伺服器的路徑，一般保留預設值即可執行程式。如果伺服器的perl程式路徑所在與預設的不同，嘗試將這一行改為 #!/usr/bin/perl。

第30行

$myurl = "http://home.pacific.net.hk/~kxxk/";

HOME連結。請改為你自己的網站位址(首頁)。

第33行

$backurl = "../index.html";

設定「返回主頁」(BACK) 的連結讓訪客回到主頁或起始之頁面。
(注意 $myurl 是以新視窗方式開啟, $backurl 則以同一窗框開啟)

第34行

$pass = "7777";

管理者密碼。此密碼也就是進入管理模式的「萬用密碼」。

第36行

$title = "我的 I-BOARD/LR 留言板";

留言板標題。如果用瀏覽器直接打開這個留言板，這個標題將會出現在瀏覽器的標題列。

請利用你最常用的純文字編輯器打開附屬程式檔「rsrch.cgi」進行下列修改程序。

第1,25,27行

#!/usr/local/bin/perl
$backurl = "../index.html";
$pass = "7777";

將這些設定值修改為與上面 ibbsr.cgi 相同即可。

■ 圖檔設定

留言圖檔功能是這個留言板的主要特色。

第63行

$i_mode= 1;

此行是控制留言圖檔功能開關的設定值。將數值改為 [0] 即表示關閉留言圖檔功能。

圖檔格式一般以GIF比較普遍採用，因為GIF圖佔位比較小、色彩簡單，而且可以製作動畫。

這些都是隨程式壓縮包附送的可愛圖圖啦！

以上就是原作者提供的範例圖檔，使用與否隨你喜歡吧。當然，你也可以將你自己畫出來的圖圖用作留言圖檔呀！

□ 範例圖檔提供 / CJ 素材 Club

補充一下，你也可以用JPEG格式的圖檔。至於想要設定自己喜歡的留言圖檔，只要在主程式檔裡面找出關於這個部份的設定再作仔細修改就可以囉！

如果圖檔並不是存放在程式所在的主機伺服器，在設定留言圖檔資料夾的路徑時必須以http://作開頭，標明圖檔的來源。設定實例如下所示。

第64行

$i_dir = "http://xxxx.xxxx.com.tw/~xxxx/icon";

要注意的是必須把路徑末端的斜線字元（/）省去。

■ 圖檔連結

如果使用者有留下個人網站位址(URL)，留言內容框的右上方會有這個網址的連結，你可以選擇以文字連結或圖檔連結來顯示。

第69行

$link_i= 1;

此行是控制圖檔連結功能開關的設定值。將數值改為 [0] 即表示以文字連結來取代圖檔連結。

第70行

$l_img = "./img/home.gif";

設定用來連結網址的HOME圖檔。如果圖檔並不是存放在程式所在的主機伺服器，必須以http://作開頭，標明圖檔的來源。

必須準確設定圖檔路徑
若圖檔是跟主程式檔放在一起，則只須改成「home.gif」或「./home.gif」即可。如果圖檔是放在跟主程式檔不同的資料夾，請利用相對路徑符號「.」或「..」加以標明。例如使用一些要將程式檔與唯讀檔分別存放在不同位置的免費空間，這個路徑設定看起來可能是這樣的：「../../ibbsr/img/home.gif」。

必須在設定檔記入圖檔闊度與高度
另外你也需要修改接下來兩行的闊度與高度的設定值 ($h_wid & $h_hei)。

以下是隨程式壓縮包附送的HOME圖檔，以作參考。

home.gif

147

=24

=19

■ 檔案架構

當你把最基本的設定值都改好了以後，最好不要急著做版面修改或什麼的，應該首先把一堆檔案傳送到主機伺服器測試一下再說。

一般來說，程式檔案可以存放在任何一個空的資料夾。如果你的網路供應商或免費空間提供者有設定某一個資料夾是用來存放網頁檔案，這個資料夾的名稱通常叫做 [ public_html ]，程式檔是需要置放在這個資料夾裡面才能正常執行的。下面以開一個新的 [ ibbsr ] 資料夾為例，說明這個程式的檔案架構。

[public_html]┐
             ├ [ibbsr] ┐(若要使用檔案鎖定/舊留言集/備份功能,要設成[777])
             │         ├ ibbsr.cgi  [755] (從頁面直接連結過來的檔案)
             │         ├ rsrch.cgi  [755]
             │         ├ ibbsr.dat  [666]
             │         ├ irbup.bak  [666] (當備份功能開啟時便會用得上)
             │         ├ irc.dat    [666] (當計數器功能開啟時便會用得上)
             │         ├ rlog.log   [666] (當舊留言集功能開啟時便會用得上)
             │         ├ [icon] ┐
             │         │        └ *.gif  (留言圖檔)
             │         └ [img]  ┐
             │                   └ *.gif  (程式圖檔)
             │
             └ index.html

[　] 內的數字為程式正常運作所需設定之檔案權限 (Permission)。

檔案/資料夾名稱	上傳模式	一般使用的檔案權限	驚直建議的「安全檔案權限」
[ ibbsr ]	程式資料夾	777	711
ibbsr.cgi	ASCII (純文字檔)	755	700
rsrch.cgi	ASCII (純文字檔)	755	700
ibbsr.dat	ASCII (純文字檔)	666	600
irbup.bak	ASCII (純文字檔)	666	600
irc.dat	ASCII (純文字檔)	666	600
rlog.log	ASCII (純文字檔)	666	600
[ icon ]	圖檔資料夾	毋須特別指定	755
[ img ]	圖檔資料夾	毋須特別指定	755
*.gif	Binary (二進位檔)	毋須特別指定	644

注意當使用FTP程式上傳檔案的時候，必須依照上列所示的上傳模式 (ASCII/Binary) 來傳送檔案，否則程式執行時可能會出現不可預期的後果。

■ 測試程式

在正式使用之前，必須先作測試確保程式能夠正常執行。如果運作順利的話，那就表示你已經安裝成功囉！:D

■ 郵件通知

程式支援寄發郵件通知的功能。只要你在程式設定好sendmail的部份，把修改好的程式上傳妥當，以後只要有使用者寫入新的記事內容，程式便會第一時間透過主機伺服器提供的sendmail程式，把記事內容的資料以郵件方式寄到你的信箱。（註：只有支援sendmail程式使用的伺服器才可以使用這個功能）

第92行

$t_mail= 0;

將此數值改為 [1] 即可啟動寄發郵件通知功能。

第93行

$mymail= 1;

設為 [1] 即表示連你自己(管理者)所寫入的記事內容資料也要寄回郵箱。
設成 [0] 即表示不會。（程式會以記事內容的「電子郵箱」欄位作對照）

第94行

$mail[0] ='user@host.com.tw';

管理者的郵箱。只有跟這個郵箱符合才會被視作「管理者」。

第95行

$s_mail = '/usr/sbin/sendmail';

sendmail路徑。請向網路管理員查詢。一般是 /usr/sbin/sendmail 或 /usr/lib/sendmail 。

■ 留言板標題圖檔

你可以秀出屬於你的留言板標題圖檔。

第97行

$t_img= "./img/ibbsr.gif";

請在這裡指定標題圖檔的路徑或網址。另外你也需要修改接下來兩行的闊度與高度的設定值 ($twid & $thei)。

以下是隨程式壓縮包附送的留言板標題圖檔，以作參考。

ibbsr.gif

685

=135

=80

■ 計數器圖檔

如果你不喜歡文字式的計數器，也可以使用自己喜歡的計數器圖檔。

第101行

$cou  = 1;

設為 [1] 即表示開啟內置計數器的功能。設為 [0] 則表示不使用此功能。
計數器圖檔必須使用下列名稱命名：

0.gif / 1.gif / 2.gif / 3.gif / 4.gif / 5.gif / 6.gif / 7.gif / 8.gif / 9.gif

要開啟圖檔計數器功能，必須設定 第99行 $m_pas=""; 的路徑，不可留空。
放在與主程式檔相同的資料夾，請把路徑設成 "."
放在與主程式檔所在同一層次的新資料夾，請把路徑設定成 "./資料夾名稱"
放在其他主機伺服器的地方，請把路徑設成 "http://～" 不包括最末斜線（/）
此外你也需要修改接下來兩行的闊度與高度的設定值 ($m_wid & $m_hei)。

■ 允許HTML語法使用

你可以設定是否允許使用者寫入含HTML語法(例如<a><font><img><b><i>等)的記事內容。

第113行

$tag  =  1;

將此設定值改成 [0] 即可禁止使用者寫入HTML語法的記事內容。

■ 簡單的舊留言集保存功能

這程式可以做簡單的舊留言集保存工作。

第116～119行

$klog_s= 0;
$klog_c= "./klog.log";
$klog_d= ".";
$klog_l= 100;

將 $klog_s 的設定值改成 [1] 即可開啟舊留言集保存的功能。
$klog_d 設定存放舊留言集檔案的資料夾。
$klog_l 設定每個舊留言集之最大Ｋ數(千位元組)。
（例如當1.txt的檔案大小超過100KB時，程式便會建立2.txt繼續保存）

注意：除了主程式檔外，你還要同時修改附屬程式檔 rsrch.cgi 裡面跟這部份相同的設定值。

■ 備份功能

萬一主記錄檔無緣無故消失，你也可以藉由備份記錄恢復過去，不致損失大量資料。

第90及91行

$bup   =  0;
$bup_f = "./irbup.bak";

將 $bup 設成 [1] 即可開啟備份功能。$bup_f 指定備份檔案的名稱。

■ 管理者專用圖檔

留言板管理者可以有一個屬於自己的專用圖檔。

第85行

$mas_i= "master.gif";

管理者留言時需要從圖檔下拉清單中選擇「管理者專用」，才可以使用這個圖檔留言。
程式執行的時候，會核對一下留言者是否為 第94行 $mail[0] 所指定的管理者郵箱。