Readme.txt for conf14.pl, red14.pl sup14.pl, post14.pl, and param14.dat

(c) 1999-2000 Softopia Development, Inc. All Rights Reserved

Setup instructions are below.

======================================================================
ABOUT
======================================================================

This package is the web interface for iTrack(tm). It's purpose is to
provide a feedback form on a web server, and record the form input to
a delimited file that can be imported by iTrack. It can also be used 
as a simple formmail or sendmail form without recording the delimited
file. The delimited file can also be imported using many database or
spreadsheet applications

When a user submits the form, a unique tracking number is generated
and recorded. This number is displayed to the user for referencing
their submittal, and is included in all records and messages.

Configuration is handled by a Control Panel script, so you do not need
to edit the scripts or configuration files. You will need to edit the
first line of each script to point to Perl on your server. You have 
complete control of the appearance of the forms, so you can easily
match your web site's look and feel. The version of this script in use
on the softopia.com site is an unmodified version of this script.

It has been tested on both Unix and Windows web servers running Apache
1.3 Server and Perl 5.

If you intend to use the option to e-mail form output, and you have a
Windows web server, you will need to acquire a Windows version of the
sendmail application. Several free versions are available from many
Internet software archives, including comMail which is available on
the softopia web site. (http://www.softopia.com/download.html)

This interface is further documented in the online help files included
in the iTrack download. (http://www.softopia.com/download.html)

======================================================================
USE
======================================================================
This script is not freeware. You are granted license to use it on your
server under the following conditions only.

- The script must remain unmodified and must display the softopia
  copyright and trademark ownership.

- The script may NOT be used on web sites that promote:

	* anything illegal
	* communism
	* religion
	* gun control
	* pharmaceuticals
	* psychiatry
	* homosexuality

- The sript may NOT be used on web sites that denigrate, portray
  negatively, or advocate prohibition of:
  
  	* ufology
  	* alcohol
  	* tobacco
  	* psychoactive drugs
  	
If you have any questions about these requirements, contact us by
e-mail and we will give you a rant-free reply.

======================================================================
FILES
======================================================================

conf14.pl	- Configures the scripts

red14.pl	- When using formmail, creates confirmation page

sup14.pl	- Displays the web form

post14.pl	- Posts the web form

param14.dat	- Configuration Parameters

hello.pl	- Simple script to test Perl on your server

hello.txt	- Contains text to be included in email messages

htmlhd.txt	- html code for the top of the forms

htmlft.txt	- html code for the bottom of the forms

support.txt	- The log file that form posts are recorded in

tracking.txt	- Contains the value of the next Tracking Number

======================================================================
INSTALLATION
======================================================================

1.) Unzip the archive and place the .pl, .dat, and html*.txt files
into your cgi directory. Some servers require that Perl scripts have
a .cgi extension, so you might have to rename the *.pl files to *.cgi.

2.) Create a /admin/ directory and put the conf14.pl script there. The
conf14.pl script *must* be located in a directory one level below the
directory of the other scripts.

3.) Password protect the /admin/ directory. Otherwise anyone would be
able to execute conf14.pl and configure your script.

4.) Create a /data/ directory and place support.txt and tracking.txt
there. You will need to chmod 777 the directory, chmod 777 support.txt 
and tracking.txt. If you use ws_ftp you can chmod by right-clicking on
a filname. chmod all of the *.pl files to 755.

5.) The first line of each .pl file is the local path to the Perl
interpreter on your server. You might need to edit these files and
change this line. Some examples are:

	#!C:\bin\perl\bin\perl.exe

	#!/usr/local/bin/perl

	#!/usr/bin/perl

6.) Run the control panel script from your browser. To run the script,
enter it's full url (e.g. http://your-domain/cgi-bin/admin/conf14.pl)
in your browser's location window.

That's all there is to it. You can open the form by opening the sup14
script in a web browser. (e.g. http://your-domain/cgi-bin/sup14.pl)

The web interface download includes a sample script named hello.pl.
This script, when called, displays "hello world" in your browser. You
should be able to successfully run this script before attempting to
run the web interface scripts. This will confirm that your CGI, Perl,
and server are properly configured.

Finally, if all of this is gobbledy-goop to you, you can visit the
softopia web site at http://www.softopia.com/websetup.html for
information on having one of our propeller heads install the scripts
for you.

======================================================================
END
======================================================================
