WWWBoard Readme

Complete installation and configuration guide for WWWBoard - the threaded bulletin board system (v2.0 ALPHA 2)

Perl v2.0 ALPHA 2 Documentation

Table of Contents

Overview

WWWBoard is the Version 2.0 of the Bulletin Board Message System. Version 2.0 has many enhancements over version 1.0 and is a complete re-write that is not backwards compatible.

Package Contents
# File Description
1ALPHA-2Release notes - READ THIS
2READMEInstall instructions (this file)
3wwwboard.plThe Perl CGI script that runs everything
4wwwboard.htmlThe HTML WWWBoard file that users see
5faq.htmlFAQ file displayed for users
6data.txtWhere the file number is stored
7messages/Where messages are created and stored
8wwwadmin.plAdmin tool to delete messages
9passwd.txtEncoded password and username for WWWAdmin
10ADMIN_READMEWWWAdmin README file

wwwboard.pl

This file must be placed in your server's cgi-bin, or renamed to wwwboard.cgi if your server allows .cgi extensions. The file must be chmoded 755.

Variables

The absolute system path to your wwwboard directory.

$basedir = "/home/yourname/public_html/wwwboard";

The base URL to the directory where wwwboard is kept.

$baseurl = "http://your.host.xxx/~yourname/wwwboard/";

The URL that points to wwwboard.pl. Used in followup form responses.

$cgi_url = "http://your.host.xxx/cgi-bin/wwwboard.pl";

The name of your messages directory (appended to $basedir).

$mesgdir = "messages";

The name of the data file that holds the current filename count.

$datafile = "data.txt";

The name of the wwwboard.html file (can be renamed to index.html).

$mesgfile = "wwwboard.html";

$faqfile Path to the FAQ file (default: "faq.html")
$ext File extension for messages (default: "html", use "htm" for DOS)
$date_command Path to the date command (default: "/bin/date")
$title Title of your WWWBoard

Options

Option Values Description
$show_faq 1 / 0 Display a link to the FAQ on every message page
$allow_html 1 / 0 Allow HTML markup in posts (0 = strip tags)
$quote_text 1 / 0 Quote previous message in followup text box (with ':' prefix)
$subject_line 0 / 1 / 2 0 = Editable quoted subject
1 = Read-only quoted subject
2 = Empty subject
$use_time 1 / 0 Show hour:minute:second time with date on main page

wwwboard.html

This file must be placed in the $basedir directory and chmoded 777 so the web server can write to it.

Required Edits:
  1. Change the <title> tag to your board name
  2. Change the <h1> header to match
  3. Update the form action to your $cgi_url
<title>Your Board Name</title>
<h1>Your Board Name</h1>
<form method="POST" action="http://your.host.xxx/cgi-bin/wwwboard.pl">

Other Files

File/Directory Location Permission Notes
faq.html $basedir chmod 744 Optional FAQ file, no editing required
messages/ $basedir chmod 777 Directory where messages are stored
data.txt $basedir chmod 777 Stores the current message number

Version 2.0 Improvements Over 1.0

  • HTML does not mess up postings like the last version did
  • Many more options to allow flexibility in design
  • One CGI program instead of three - more efficient
  • File names use incremented numbers up to 99999 (no overlapping like with old PIDs)
  • Cleaner code and better error handling

Version History

Version Date Changes
2.0 ALPHA 1 11/04/95 Complete re-write of Version 1.0; Released due to popular demand
2.0 ALPHA 2 11/25/95 Bug fixes and improvements

Related Documentation

FormMail Readme

Installation guide for the FormMail script

Guestbook Readme

Installation guide for the Guestbook script

All Readme Files

Browse all script documentation