WWWOrder

#######################################################################
#                                                                     #
#                 wwworder.cgi - v2.1 - by Michael Hall               #
#                                                                     #
#         Copyright ©1996 by Virtual Marketing Technologies.          #
#                         All Rights Reserved.                        #
#                                                                     #
# The user of this script is licensed to use this script on one       #
# machine only for non-commercial use only.  For commercial use, a    #
# payment is required.  See The Scripts Home at                       #
# "http://www.virtualcenter.com/scripts2" for more details.  Use of   #
# this script means acceptance of this license agreement.  Commercial #
# use of this script without payment is a violation of copyright laws #
# and subject to fines and/or prosecution.  If you have questions     #
# regarding the use of this script for commercial purposes, please    #
# e-mail vmt@airmail.net.  The author of this script cannot be held   #
# responsible for any errors or cause of loss due to this program.    #
# Use of this program is provided as is.  No other warranties are     #
# expressed or implied.                                               #
#                                                                     #
# If you do not pay for a license to use this program, you may not    #
# edit out any sections of this script that give credit and links to  #
# the author, The Scripts Home, and Virtual Marketing Technologies.   #
#                                                                     #
#######################################################################

CHANGES IN THIS VERSION
-----------------------

The only major changes to this version are that it no longer requires the
cgi-lib.pl or cgi-test.pl libraries and has been renamed wwworder.cgi so
as to be compatible with directories that will only recognize Perl scripts with
the .cgi extension.  This should aid in installation of this program as no
other programs are needed for this to run.


INSTRUCTIONS FOR SETTING UP THE WWWORDER.CGI SCRIPT

This script requires atleast Perl v4 to run.  Place it in your cgi-lib
directory on your web server and "chmod 755" to turn it into an
executable script.

You'll need to do some adjusting to the script to customize it for your
own site.  Find the section of the script titled "Edit the following
variables...." and make the following changes:

	$BaseDir = "/var/www/docs/orders/tests/";
		Change this path to the path where you want your orders file
		saved.
		

Now, you'll need to edit the included orderform html file for your
own order form.  Find the file "OrderScripts.html" and make the
following changes:

	<input type="hidden" name="OrderFile" value="ScriptOrders.dta">
		Change the value to whatever filename your script order data
		file is.  This is the file that the script writes all orders
		to.
		
	<input type="hidden" name="DataFile" value="ScriptItems.dta">
		Change the value to whatever filename your script items data
		file is.  This is the file that has the prices and descriptions
		of what you are selling.
		
	<input type="hidden" name="Tax" value=".085">
		Change this to the rate of your sales tax.  If your local sales
		tax is 8.5% then, in decimal value, your value will be .085.
		For a 7.25% sales tax, your value will be .0725.
		
	<input type="hidden" name="Shipping" value="0.00">
		If you require a shipping charge, put it here.  If you need
		different shipping charges for different items, just make the
		shipping charges as a seperate item that users can select in
		the form.
		
	<input type="hidden" name="NumChoices" value="5">
		Change the value to the total number of items you are selling.
		
Now add your items to the form.  Each item is named by the number.  For
instance, the first item will have the input name as "1" and so on.  The
value should always be "Checked" since this is what the script looks for
to see if an item has been ordered.  The description can be whatever you
want.

You can go by the example form for an idea of how to set up your own.


Now, you need to set up your ScriptItems.dta file.  Put it in the directory
that you chose under $BaseDir in the script and "chmod 755" this file.

Next, starting with the first item in your order form, list the item descriptions
of each item (in order as they were listed in your order form) on each line.  Next,
again in order, list on each line the price of each item.  Then save this in your
$BaseDir.  You must make sure that it is saved in UNIX format so the line feeds and
carraige returns are correct.  If you edit this on a Mac or PC, make sure you have
it saved as a text file on your Unix system or else it won't be read correctly.

Next, place the ScriptOrders.dta file in the same directory as $BaseDir and
"chmod 777" this file.  It will be written to with the address and order info for
each order.

Now you're all set.  Make sure your order form is pointed to "post" the information
to the directory and file of the script.  It should work.


END-USER LICENSE
----------------

The user of this script is granted the use of this program on one server only.  This
script cannot be sold or transfered to anyone without the express written permission
of Virtual Marketing Technologies (VMT).  VMT gives no warranty for this software and
the user agrees to use the program at his/her own risk.  No warranties are offered or
should be implied.  Sale of this program to others without the permission of VMT is
a direct violation of international copyright laws and the violator will be prosecuted
to the fullest extent of the law.

You may not use this program for commercial purposes in any way without first purchasing
a commercial user license from Virtual Marketing Technologies.  You may use a period of
time to test it for yourself privately but may not use it publicly unless you have
purchased a license.  Failure to do so is a direct violation of international copyright
laws and the violator will be prosecuted to the fullest extent of the law.


NOTICE ON SUPPORT
-----------------

Support is available only to those who purchased support when they purchased this script.
To gain that support, simply send an e-mail to "vmt@airmail.net" and include
the support number you got with the e-mail for this script.

If you did not purchase the support but find you are having problems, a special
message forum has been set up in The Scripts Home at "http://www.virtualcenter.com/scripts2"
for those needing help.  If you are able to successfully setup this program, please stop
by these message forums and help others set them up.

If you need help, please post a message to this message forum.  DO NOT send e-mail to the
author or Virtual Marketing Technologies unless you have purchased a license.  These scripts
are provided at no charge for personal, non-commercial use and we simply don't have the
resources to provide further support at no charge.


NOTICE ON INSTALLATION
----------------------

Installation of this program is available from Virtual Marketing Technologies at the
standard rate of $50/hour (minimum 1 hour).  If you find it too difficult to install
this program on your own, you may request custom installation.  $50 is due immediately
before installation can be started.