http://www.openscripts.com/
Rev. 9/01/00
                   _____________________________
          
                      O p e n A u c t i o n D B
                   _____________________________
                   The Freeware Auction Solution

-----------------------------------------------------------------
-->READ THIS CAREFULLY BEFORE INSTALLING OR USING OPENAUCTION<--
-----------------------------------------------------------------

OpenAuctionDB Release Version 1.01b1
Copyright (C) 2000 OpenScripts.com
http://www.openscripts.com/
Original Copyright (C) 2000 EverySoft

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., 59 Temple Place - Suite 330, Boston, MA
02111-1307, USA.

-----------------------------------------------------------------


These are not a beginners scripts! If this were a movie
it would be rated R-X.
If you need or want commercial support go to:
http://www.openscripts.com





1. Make a data directory that is given write permissions. It should *not* be 
be in the web space. If you don't know what this means don't even
*think* of doing anything serious with these scripts.

2. Make a directory and place the included .html templates in it. 
This can be in or out of the web space. 

3. Make a directory and place the included perl libraries in it. This can
be in or out of the web space. If you place them in the web space make sure
the server is configured to execute the .pl and .pm extension. Otherwise you will
will create a security hole by serving the source. 

4. Open openauction.cgi with a plain text editor and edit the
fourth line of the file to point to the directory that contains the perl libraries
contained in the package. Also, edit the first line of this script to 
point to the perl executables on your system.

5. Put openauction.cgi in your cgi-bin dir and give it executable
permissions.

6. Open config.pl with a plain text editor and edit all of this:

#-#############################################
# Configuration Section
# Edit these variables!
#
#
# List each directory and its associated
# category name.  Subdirectories should be
# children of an upper directory. ie all chidren
# must have a parent.Subcategories may be nested as
# deeply as you wish.

%category = (
	'antiques' => 'Antiques',
	'antiques/Pre_1900' => 'Antiques:Pre 1900',
	'antiques/Post_1900' => 'Antiques:Post 1900',
	'antiques/Other' => 'Antiques:Other',
	'books_movies_music' => 'Books, Movies & Music',
	'books_movies_music/Books' => 'Books, Movies & Music:Books',
	'books_movies_music/Movies' => 'Books, Movies & Music:Movies',
	'books_movies_music/Music' => 'Books, Movies & Music:Music',
	'coins_stamps' => 'Coins & Stamps',
	'coins_stamps/Coins' => 'Coins & Stamps:Coins',
	'coins_stamps/Stamps' => 'Coins & Stamps:Stamps',
	'collectibles' => 'Collectibles',
	'computer_hardware' => 'Computer Hardware',
	'computer_software' => 'Computer Software',
	'consumer_electronics' => 'Consumer Electronics',
	'dolls_figures' => 'Dolls & Figures',
	'dolls_figures/Dolls' => 'Dolls & Figures:Dolls',
	'dolls_figures/Figures' => 'Dolls & Figures:Figures',
	'jewelry_gemstones' => 'Jewelry & Gemstones',
	'jewelry_gemstones/Jewelry' => 'Jewelry & Gemstones:Jewelry',
	'jewelry_gemstones/Gemstones' => 'Jewelry & Gemstones:Gemstones',
	'music_instruments' => 'Music & Music Instruments',
	'music_instruments/Music' => 'Music & Music Instruments:Music',
	'music_instruments/Instruments' => 'Music & Music Instruments:Music Instruments',
	'photography' => 'Photography',
	'pottery_glass' => 'Pottery & Glass',
	'pottery_glass/Pottery' => 'Pottery & Glass:Pottery',
	'pottery_glass/Glass' => 'Pottery & Glass:Glass',
	'sports_memorabilia' => 'Sports Memorabilia',
	'toys' => 'Toys',
	'miscellaneous' => 'Miscellaneous',
	);

# The Data Directory. We need an 
# absolute path from the server root for the data directory you just created. 
# Include the trailing slash. THIS SHOULD 
# NOT BE WEB-ACCESSIBLE! 

$config{'basepath'} = '/home/user/auctiondata/'; 

# The Template Directory. We need an 
# absolute path from the server root for the template directory.
# Place all the .html templates here. 

$config{'templatepath'} = '/home/user/templates'; 

# Closed Auction Directory 
# This is where closed auction items are stored relative to the basepath. 
# Include the trailing slash. 

$config{'closedir'} = 'closed/'; 

# User Registration Directory 
# This is where user registrations are stored relative to the basepath. 
# Leave this blank if you don't want to 
# require registration. It can potentially 
# take up quite a bit of disk space. 

$config{'regdir'} = 'reg'; 


# This is the password for deleting auction
# items.

$config{'adminpass'} = 'auction';

# You need to assign either a mail program or
# a mail host so confirmation e-mails can
# be sent out.
# Leave one commented and one uncommented.
#
# YOU NEED EITHER A MAIL PROGRAM

 $config{'mailprog'} = '/usr/sbin/sendmail';

#
# OR YOU NEED A MAIL HOST (SMTP)

#$config{'mailhost'} = 'localhost';

# This line should be your e-mail address

$config{'admin_address'} = 'nobody@yourhost.com';

# This line should point to the URL of
# your server.  It will be used for sending
# "you have been outbid" e-mail.  The script
# name and auction will be appended to the
# end automatically, so DO NOT use a trailing
# slash.  If you do not want to send outbid
# e-mail, leave this blank.

$config{'scripturl'} = 'www.yoursite.com';

# This will let you define colors and properties
# for the tables that are generated and the
# other page colors.  The default colors
# create a nice "professional" look.  Must
# be in hex format.

$config{'tableborder0'} = 0;
$config{'tableborder1'} = 1;
$config{'tablecellspace0'} = 0;
$config{'tablecellpad0'} = 0;
$config{'tablecellpad1'} = 1;
$config{'colortablehead'} = '#98CDCD';
$config{'colortablebody'} = '#FFFFFF';

# Site Name (will appear at the top of each page)

$config{'sitename'} = 'Your Site Name';

# You can configure your own header which will
# be appended to the top of each page.

$header =<<"EOF";
<BODY TEXT=#000000 BGCOLOR=#FFFFFF LINK=#000088 VLINK=#000088 ALINK=#000088>
	<TABLE WIDTH=100\% BORDER=0><TR><TD VALIGN=TOP WIDTH=100\%>
		<FONT SIZE=+2>OpenScripts.com</FONT>
		<BR>
		<FONT SIZE=+1>Online Auction</FONT>
	</TD><TD VALIGN=TOP ALIGN=LEFT>
		<FORM ACTION=$ENV{'SCRIPT_NAME'} METHOD=POST>
		<INPUT TYPE=TEXT NAME=searchstring>
		<INPUT TYPE=SUBMIT VALUE="Search">
		<INPUT TYPE=HIDDEN NAME=action VALUE="search">
		<FONT SIZE=-2><INPUT TYPE=RADIO NAME=searchtype VALUE="keyword" CHECKED>keyword <INPUT TYPE=RADIO NAME=searchtype VALUE="username">username </FONT>
		</FORM>
	</TD></TR></TABLE>
	<P>
EOF

# You can configure your own footer which will
# be appended to the bottom of each page.
# Although not required, a link back to
# openscripts.com will help to support future
# development.

$footer =<<"EOF";
<P>
<CENTER><FONT SIZE=-1><I>Powered By <A HREF=http://www.openscripts.com/>OpenAuction Preview 1.0</A></I></FONT></CENTER>
</BODY>
</HTML>
EOF
#
#-#############################################

# Sniper Protection...  How many minutes
# past last bid to hold auction.  If auctions
# should close at exactly closing time, set
# to zero.

$config{'aftermin'} = 5;

# File locking enabled?  Should be 1 (yes)
# for most systems, but set to 0 (no) if you
# are getting flock errors or the script
# crashes.

$config{'flock'} = 1;

# User Posting Enabled- 1=yes 0=no

$config{'newokay'} = 1;

# Add meta tags to the pages.

my $metadesc = "This is the coolest free auction on the internet, baby.";
my $metakeywords = "auction, free auction, cool auction";

#In order to properly config the navigation bar edit these:

my $regdir = 1;
my $closedir = 1;

#Some image definitions

my $picicon = "<img src = \"http://auction.yoursite.com/images/pic.gif\">";
my $newicon = "<img src = \"http://auction.yoursite.com/images/new.gif\">";
my $hoticon = "<img src = \"http://auction.yoursite.com/images/hot.gif\">";
my $descicon = "http://auction.yoursite.com/images/descicon.gif";
my $bidicon = "http://auction.yoursite.com/images/bidicon.gif";

