#######################################################################
#                                                                     #
#                 postcard.cgi - v1.0 - by Michael Hall               #
#                                                                     #
#         Copyright 1997 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 a trial period of      #
# thirty (30) days.  After that time, user is requested to pay the    #
# shareware fee to continue using the script.  For commercial use, a  #
# payment is required.  See The Scripts Home at                       #
# "http://www.scriptshome.com" 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 scripts@scriptshome.com.  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.   #
#                                                                     #
#######################################################################

README File for Setting up the digital postcards.

Look through the script and make the adjustments mentioned in the comments.
Primarily, these places are at the beginning of the script.  You'll need to
edit the two variables "$BaseDir", "$Pictures", "$PostcardURL", and others.
"$BaseDir" should point to your postcards directory where the datafiles will be
stored.  "$Pictures" is the directory where you will store the pictures that
users can choose from to be used in the postcard they create.  "$SiteEMail"
is the e-mail address to your site.  "$SiteURL" is the URL to your site.
"$CardSubject" is the text that will be displayed in the subject line of the
e-mail the system sends the receiver of the postcard.  "$SiteName" is the name
of your web site.  "$AllowHTML" determines whether the sender of the postcard
can use HTML commands in his/her comments.  If you wish to allow for HTML
in the postcard message, set this to 1.  Otherwise, set it to 0 and it will
automatically filter out any HTML commands the user attempts to put in.
"$mailprog" should be the full path to your mail program on your server.
"$Header" and "$Footer" are what you wish to be displayed at the top and bottom
of the screen when the postcard is shown to the receiver.  You'll need to put a
backslash "\" in front of any quotes "" or other backslashes so as not to interfere
with the perl script.

Make sure you "chmod 777" the directory you specified in "$BaseDir" since this script
will need to write to this directory.

Next, just place some pictures in the directory you specified in "$Pictures" and set up
your HTML page.  A sample HTML page has been included.  Due to licensing agreements, we
could not include the pictures in this package so you'll need to get your own.



PAYING THE SHAREWARE FEE
------------------------

You are free to try out this script for 30 days.  After that, we ask that you pay the
requested shareware fee.  You can find the shareware fee for this script on the script's
page on The Scripts Home (http://www.virtualcenter.com/scripts2).  If you are operating a
commercial site (i.e. you are a company, charge advertising, or charge access to the site),
you must pay the commercial fee.

Failure to do so is a direct violation of copyright laws and subject to prosecution.  Please
help support shareware.  It helps provide updates and additional scripts for you to download.


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

Support is not included with this software.  If you have trouble setting it up, please
post a message on the message forums on The Scripts Home.  DO NOT SEND E-MAIL TO US FOR
HELP ON INSTALLATION.  If you desperately need someone to install it and get it working
for you, send a check or money order (in U.S. funds) to Virtual Marketing Technologies,
P.O. Box 592, DeSoto, TX  75123 for $50 along with your name, address, phone, fax, and e-mail
address plus the URL to your web site and where you want the script installed.

If you need help, please post a message to this message forum.  DO NOT send e-mail to the
author or Virtual Marketing Technologies.  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.


NOTICE ON PAYMENT
-----------------

If you choose to use this script on your web site, please send a check or money order for
$10.00 to Virtual Marketing Technologies, P.O. Box 592, DeSoto, TX  75123.  This fee allows
you to use this script in one form on one domain for one site only.  Each additional copy
or site or domain must be registered as well.  No technical support is available for this
software regardless of whether the registration fee is paid.
