#************************************************************************
    WWWThreads	- Interactive Discussion Forum
    Copyright (C) 1998  Rick Baker

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
#***********************************************************************

#***********************************************************************
# Description
#***********************************************************************

WWWThreads is a interactive web-based discussion forum featuring
user registration, built-in search engine, multiple forums, direct
email replies, highly customizable with a complete admin section and
much more. It has been released under the terms of the GNU GPL.

#***********************************************************************
# Using the Program
#***********************************************************************

Edit The variables in the wwwthread_variables file as follows:

   $cgiurl = The URL of the cgi-bin you are using
   $imageurl = The URL of the directory where you will place all of your
               images.
   $logourl = The URL you want the logo to link to.
   $data_db = The directory where all of the board data will be stored.
   $mailprog = The system path to your sendmail program

   $cexp = When permanent cookies will expire. This date must be in the         
           proper format. Do not change unless you know about cookies.
   $bodybg = The background color of the pages.
   $title = What appears in the browser title bar.
   $homeurl = Where the link at the bottom of the page should go.
   $urltitle = The title of the $homeurl link.
   $emailaddy = Email address at the bottom of the pages.
   $emailtitle = What the title of the $emailaddy link will be.
   $adjtime = Use 1,2,3,-1,-2,3,etc. to adjust the program time several
              hours.
   $showip = 1 = The ip address of the poster will be shown.
             0 = The ip address of the poster will not be shown.
             (Either way the ip address will allways be tracked)

Place all of the images in the directory that you specified with
$imageurl, if you choose to use a very dark background color you may want 
to use the images in the darkimages.tar.gz file, these are the default
images for dark backgrounds. 

Place all of the .html, .cgi , .pl files  in your cgi-bin


Next create a directory called 'data' where you specified with $data_db
and chmod this to 777.

After changing all of the variables in the wwwthread_variables.pl file and
changing the file permissions, you have 2 options. If you have telnet
access to the machine, run the program wwwthread_startup.cgi from
the command line, by typing ./wwwthread_startup.cgi. This will step you
through some questions that will set up your first discussion board.

If you do not have telnet access you will need to run the administration
program. Enter a blank username and password. Choose edit admin and change
the admin username and password. Next you will want to create a board. 

When you have finished with there will be several files and a directory in
your data directory. You need to chmod the files to 666 and the directory
to 777.

The look and colors of the board are easily customized by editing the
variables file to suit your tastes.

Now you can get to the program by going to the url you specified in the
variables file and adding wwwthread.cgi (for example: 
http://your.domain.com/cgi-bin/wwwthread.cgi).

Or you can go to the admininstration page by going to (for example:
http://your.domain.com/cgi-bin/wwwthread_admin.cgi).

Rick Baker
rbaker@techline.com
http://www.screamingweb.com