Changes from 3.0c to 4.0
# - Split the script into sub scripts for faster reading
# - Seller to Ban Bidders (I don't like this but others want it)
# - Added and changed user registration and address fields.
# - Fixed Item emails to correct url of auction.
# - Ask seller question fix (NOT TO DISPLAY EMAIL ADDY)
# - Seller to enter currency for auction item being posted.
# - Sub Categories (BE SURE TO READ THE README FILE IF YOU AREN'T A PRO)
# - Added time auction started to the aucton item display
# - Fixed Proxy Bidding Error.
# - Fixed Feedback script and it is now Ebay Style
# - Added administrator to edit user feedback in the admin.pl file
# - Fixed security breach of html posting in auctions
# - Added New auction icons

Notice:

IF YOU ARE UPGRADING FROM A VERSION EARLY THAN 3.0
YOU MUST NOT HAVE ANY RUNNING AUCTIONS ACTIVE.
IF YOU INSTALL THIS OVER A PREVIOUS VERSION IT WILL NOT SHOW THE AUCTION ITEMS.
BACK UP YOUR PREVIOUS SCRIPT IN CASE THERE ARE ERRORS AND YOU CAN'T GET THIS WORKING.
REMEMBER IF YOU ARE USING FRONTPAGE TO PUBLISH TO YOUR SITE, FRONTPAGE WILL MOST
LIKELY DELETE YOUR DIRECTORIES AND ALL FILES WITHIN IT. DO NOT PUBLISH BUT ONLY
FTP USING A FTP PROGRAM.

Editing ezauct.pl Script
Open your ezauct.pl script and edit the following variables below.  Look at the commented out parts of the script. They include instructions on how to modify the script to run on your server.  It will help to look at the script before you try to edit and install it.  Also, read these instructions carefully the new version requires a lot of editing.

Scroll down a little bit and find the line that says require etc.  If you are on an NT system you might have to set the full path to these .pl files in your cgi-bin directory.  If you are using a Linux/Unix system you do not have to set the path for each individual file.

Find: $config{'basepath'}
Edit that to point to the path of your www directory of auction

Find: $config{'closedir'}
Enter the name of the directory you want closed auctions to be moved to
If you do not want to save closed auctions leave this blank 
Create this directory in your public_html/auction/ directory and CHMOD 777

Find: $config{'autodelclosed'}
Enter the number to which in days that you want the script to delete all closed auctions older than those days.

Find: $config{'regdir'}
Enter the name of the directory where you want registered user information to go to
If you do not want users to have to register leave this blank

Find: $config{'newestmember'}
Enter in the directory where you want new member information stored to
If you do not want to welcome new registered members leave this blank

Find: $config{'bandir'}
Enter the name you want to call the banned bidders directory.
Create this directory in your public_html/auction/ directory and CHMOD 777

Find: $config{'wantedfile'} = 'wanted';
Set this to the name of the directory you want to call for auto notification of auctions posted.
Create this directory in your public_html/auction/ directory and CHMOD 777

Find: $config{'notifydays'} = 30;
Set this to how long you want to keep auto notify records in your database.  This is the maximum amount of days even if a user chooses their own expiration date.

Find: $config{'user_autonotify'} = 0;
Enter if you want users to set their own notification expiration date for Auto Notify.  If yes put 1 if no leave it at 0

Find: $config{'feeddir'} = 'feedback';
You can leave this as is.  All user feedback will go in this directory.

Find: $config{'feedbreak'} = 25;
You can leave this as is. This displays how many feedbacks do you want to display per page.

Find: $config{'linkemail'} = 0;
Enter 1 for yes or 0 for no if you do not want user's emails to show who post feedback to be displayed.

Find: $config{'emailfeed'} = 1;
Do you want email to be sent to Users when feedback has been left on them.  1 = Yes 0 = No

Find: $config{'adminpass'}
Edit this to point to the password for you to remove auctions off of the server
YOU MUST LOGIN TO YOUR AUCTION ADMIN /cgi-bin/auction/ezauct.pl?action=admin

Find: $config{'mailprog'}
If you are using Sendmail edit this to point to where sendmail is on your server
If you are using SMTP mail 3 lines below this line is the coding for SMTP mail

Find: $config{'admin_address'}
Enter your email address

Find: $config{'scripturl'}
Enter the URL to your domain such as what you will see in the script
http://www.yourdomain.com

Find: $config{'wantedurl'}
Enter the URL pointing to where the wanted.pl script is in your CGI-BIN

Find: $config{'colortablehead'}
Enter in the hex color or text color of the head table
Right below for colortablebody enter in the color for the text
Right below that are color variables for your background links etc.
Enter in those variables as well.
NOTE: YOU MUST ENTER $config{'BGCOLOR'} and the others for links visited
links etc. Into your script's header for the background colors.

Find: $config{'sitename'}
Enter in the name of your site

Find: $config{'aftermin'}
Enter in how many minutes until auction is closed really...

Find: $config{'flock'}
Set to 1 if on unix set to 0 if not.

Find: $config{'newokay'}
Set this to 1 if you want users to post items

Find: $config{'goinghours'} = 3;
Set this to the amount of hours you want to show as going items.

Find: $config{'newdays'} = 1;
Set this to the amount of days an item is to be supposedly new.

Find: $config{'trackhot'}
Set this to how many bids you want to show if an item is hot in the track / watch area.

Find: $config{'trackcolorevenrow'} & $config{'trackcoloroddrow'}
Change these to the colors that you want .  You can make them the same as the others above.

Find: $config{'trackpath'}
Create this directory in your public_html/auction/ directory and CHMOD it to 777

Find: $config{'header'}
The header needs to be edited you must configure it. Don't forget to add this search form for your auction site into your header. Remember do not use " in your coding. EDIT BETWEEN THE TWO EOF TAGS WITHIN THE SCRIPT

Copy and Paste The Coding Below For the Search Form:

<form ACTION=$ENV{'SCRIPT_NAME'} METHOD=POST> <input type=hidden name=action value=search><center><b>Search Auction For:</b> <input TYPE=TEXT NAME=searchstring size=20> <input TYPE=SUBMIT VALUE=Search><br> <input TYPE=RADIO NAME=searchtype VALUE=keyword CHECKED>Keyword <input TYPE=RADIO NAME=searchtype VALUE=username>Username</form>

Find: $config{'footer'}
You must modify what you want people to see at the footer of your auction. You can just make it say, "yoursite is copyright 2002 etc."

Creating and Editing Categories
This is relatively easy, but please focus and follow these instructions.  It is important that you do not mess up.  Your main categories and subcategories will not work if you do not try to do this accordingly.  There are pre configured categories and sub categories and changes made for an Ebay style category list. Either leave these as is or read the instructions to change these. This can get confusing.  But if you study what the script has and what needs to be changed it can be easy.

The second line in the script
use vars qw(%config %category %access %books %misc %paper %records %form $i %fb);

needs to be changed to show the main categories that YOU want.  For example.  You see %access %books %misc %paper %records  these are the main categories for my genealogy site.  %access being Accessories %books being Books, etc. If you want to change them remove them and call them by what you want for your main categories ex:

%books %cd %software %jewlery etc.

Scroll down until you see %category = (

These are the categories of your auction.  As you see there is a01 which is Accessories General and then a02, a03, a04 etc. etc.  Make sure that you put the main category in bold typed text.  The others below it are the sub categories.  You need to do this for each Main Category and Sub Category that you are going to create.

Scroll down until you see %access = (

This is the category and subcategories for Accessories.  In this you will put the categories you typed above for a01 etc.  You do this for each main category you created in the 2nd line of the script.  If you don't have the main categories that you specified on the 2nd line of the script then you create them as you see for example in the ones that I have created.

Scroll down until you see the elsif's 

This is very important.  An example is below. You will need to create these right above the last line you see below. This is to make sure that your categories when clicked on will show the sub categories that you have created.  These are defined in the 2nd line of your script.

elsif ($form{'action'} eq 'access') { &access; } #Accessories Category
elsif ($form{'action'} eq 'books') { &books; } #Books Category
elsif ($form{'action'} eq 'misc') { &misc; } #Miscellaneous Category
elsif ($form{'action'} eq 'paper') { &paper; } #Paper Items Category
elsif ($form{'action'} eq 'records') { &records; } #Records Category
elsif ($form{'item'} eq int($form{'item'}) and $category{$form{'category'}}) { &dispitem; }

Scroll down to sub dispcat = (

This is where you create your category display for your page.  Between the EOF tags you will enter in the html coding to display your sites category display.  I included a category image and also the category URL. 

Call the categories image with:
<img border="0" src="$config{'scripturl'}/auction/thecats.gif" width="20" height="15">

Call the Categories links with:
<A HREF=$ENV{'SCRIPT_NAME'}?action=access>Accessories</A>  Change access to the name that you specified in the 2nd line of the script without the % sign.  and Change the text to the name of the main category.

Scroll down near the bottom where you see # These are the sub category display pages. You need to read the instructions This is where you will create your sub category display pages. Pay attention because you will need to understand what to do here.

First copy and paste or edit the ones that are there.  They will be called sub access, sub books etc.  This below is what you will copy and change to create your category display pages.  Only change what is in bold.  For example:  access needs to be changed to the name of the category you put in line #2 of the script.  Then change the title display for the category name. Then change where you see %access to the category you chose in line #2 of the script.  Keep the % sign.  You must do this for each category that you have created.

sub access {
&chkclose;
print $config{'subheader'};
print "<div align=center><center>";
print "<table border=0 cellspacing=0 style=border-collapse: collapse width=50% bgcolor=$config{'colortablehead'}>";
print "<tr><td width=100%>";
print "<div align=center><center>";
print "<table border=0 cellpadding=2 cellspacing=0 style=border-collapse:collapse bordercolor=$config{'colortablehead'} width=100%>";
print "<tr><td width=100% colspan=2 bgcolor=$config{'colortablehead'}>";
print "<p align=center><b><font color=$config{'colortablebody'} face=Arial size=2>Accessories Categories</font></b></td></tr>";
my $key;
foreach $key (sort keys %access) {
umask(000); # UNIX file permission junk
mkdir("$config{'basepath'}$key", 0777) unless (-d "$config{'basepath'}$key");
opendir DIR, "$config{'basepath'}$key" or &oops("Category directory $key could not be opened.");
my $numfiles = scalar(grep -T, map "$config{'basepath'}$key/$_", readdir DIR);
closedir DIR;
print "<tr><td width=87% bgcolor=$config{'colortablebody'}>";
print "<p align=left><font face=Arial><small><A HREF=$ENV{'SCRIPT_NAME'}\?category=$key\&listtype=current>$category{$key}</A></td>";
print "<td width=13% bgcolor=$config{'colortablebody'}><font SIZE=2 face=Arial><p align=center><b>\($numfiles\)</b></font></td></tr>";
}
print "</table></center></div></td></tr></table></center></div>\n";
}

Editing wanted.pl Script

This script must be edited very carefully.  One mess up can ruin the whole script.  First open wanted.pl and change the path to perl at the very top.  Scroll through the whole entire script and change what is necessary and what is noted.  The commented out text gives instructions inside the wanted.pl script.

Installing EzauctIE

Installing EzauctIE isn't difficult.  Now that you have done most of the work, all you have to do is the following below.

1ST.
Create a sub directory under your public directory named auction and chmod it 777
THIS MUST EXIST OR THE SCRIPT WILL NOT WORK. THERE ARE PREDEFINED CODES IN IT
ie: /public_html/auction/

2ND.
Create a directory under your cgi-bin directory called auction\
THIS MUST EXIST OR THE SCRIPT WILL NOT WORK. THERE ARE PREDEFINED CODES IN IT
ie: /cgi-bin/auction/

3RD.
Upload all images and html to your auction directory under your public directory
ie: /public_html/auction/

4TH
Upload all .pl files into your cgi-bin/auction directory in ASCII mode and chmod it 755
Upload the comments.txt file to the same cgi directory and chmod to 777

Customizing EzauctIE
You can easily customize EzauctIE by changing the icons for the auction.  Just find the icons that you want to change, name the new ones the names of the old ones and easily upload them to your site directory where you have /public_html/auction/  Thats it.

Accessing EzauctIE
To open your auction script go to your site through the web browser and point it to your cgi-bin/auction/ezauct.pl script.  To administer your auction site go to your web browser and point it to your cgi-bin/auction/ezauct.pl?action=admin  Log into your admin area using the password you edited within the script.  All functions for deleting auctions and sending email to your users is there.