vB Easy Auction v1.1

vB Easy Auction v1.1
by yoyoyoyo

Don't let the length of this post fool you... this is actually very simple to setup... I just tend to get long-winded at times...

WHAT YOU NEED:

* vBulletin Software (for vBulletin integration - the perl files will work fine without vBulletin)
* Web server account that has CGI capabilities, and will allow you to run executable cgi files.
* Perl 5.6 or better installed on that web server. Contact your server administrator if you are unsure (most servers are running version 5.8.X, so this should not be a problem). If you do not have perl installed then read a little further below about perlsp.
* Access to either Sendmail, BLAT, or Sockets mail. No mail can be sent without at least ONE of the above. If you are using either BLAT or Sockets mail (NT users usually), you will also need access to an SMTP mail server. Contact your server administrator to find out if you do. Note: the SMTP mail server needs to allow the user to send mail without requiring them to log into the server.

OVERVIEW

This will add auctions to your site quickly and easily. Simply edit the auction.pl file and admin.pl files to reflect your server's filepaths, etc., and then upload the files to your server. Create a template and make a couple edits to your vbulletin files to allow navigation to your auctions and that is it! The core of the auction is based on a HEAVILY modified version of EveryAuction Release Version 1.53, and can be further edited or modified to suit your needs, as long as you follow the GNU public license.

SEE POST #1 OF THIS THREAD FOR INSTALL INFO, ETC.

If members of your site are interested in participating in the auctions then they need to register for them also, since this is not integrated with the vBulletin database for security reasons (since people put actual contact info, etc. in their auction registrations).

FEATURES

• a comprehensive, professional user interface that makes navigation simple
• auction classifieds or traditional auction settings
• configuration takes only a few minutes if perl is installed on your system
• colors and tables can be easily changed to match the look and feel of your system
• supports HTML front-ends
• unlimited categories and items
• category listing lists number of open items per category
• item listings list items, closing time, and current bid
• automated e-mail validation registration system keeps non-legitimate users out of your database
• system generated easy-to-remember (and user changeable) passwords sent to users via e-mail
• users must "sign" an agreement upon registration.
• optional non-registration mode allows fast posting or bidding by anyone
• users may update their contact information, password or Registration E-Mail.
• any registered user can post an item using the easy-to-use submission system
• images can be posted along with an item description and starting bid
• supports reserve prices which allow a seller to set a minimum sell price above the minimum bid
• seller determines minimum bid increment and length of the auction
• item preview before an item is actually posted
• each item is given a unique ID number and URL, so sellers can advertise their auctions in newsgroups or via a link
• item display lists bidding history and product information
• displays Closed items in a table with Radio Buttons for Selection
• bidding is easy with the minimum bid price displayed on the item page along with a quick bid form
• sellers can choose the ending time of an auction
• amount of time left in each auction is displayed in the listing
• outbid e-mails automatically sent by the system with a link back to the auction item
• sniper protection: auctions can close a configurable time after the last bid and the designated closing time, or the admin can choose to disable the sniper protection
• integrated search engine allows search by username or keyword
• users can view closed auction history and contact information depending on whether he/she is the buyer, seller, or losing bidder
• auction items may be deleted or updated by the system administrator using a password
• e-mail sent to both high-bidder and seller on auction close
• fast re-posting of items that were not sold
• data file construction allows experienced administrators to add, remove, or edit items or users by simply editing a plain text file
• everything is compressed into a single lightning-fast perl script
• advanced file locking system eliminates the risk of data corruption even during heavy bidding
• separate secure Admin Console
• pagebreaks in listings
• automatically updates the bids on the item display page
• seller can edit an auction if there are no bids.
• auto-prune of old inactive user data (admin specified length of time)
• prevents email registration from the same address more then once
• users must enter valid e-mail addresses when signing up for the auctions.
• enter e-mail addresses twice
• "e-mail auction to friend" option
• view all auctions option

LEGAL NOTICE

Version: vB Easy Auction 1.0
Last update: 07/20/2005

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.

modifications and integration with vbulletin
released at vbulletin.org by yoyoyoyo
No additional rights reserved by the author

Matt Hahnfeld DBA EverySoft expressly emphasizes that
this program is *NOT* an official release version of
EveryAuction, and that this program is *NOT* sanctioned
or distributed by Matt Hahnfeld DBA EverySoft.

Dieter Werner expressly emphasizes that
this program is *NOT* an official release version of
eAuction, and that this program is *NOT* sanctioned
or distributed by Dieter Werner.

vB Easy Auction for vBulletin is not affiliated with eBay or jelsoft or any affiliated companies.

The author of this release agrees to these statements absolutely.

VERSION 1.1: Added the optional ability to allow users to create their own auction sites using the easy-auction ezauctgn.zip script.

PLEASE CLICK INSTALL IF YOU FIND THIS USEFUL!

[Tradjick]

This looks like an extreeeeemly great addition to vB. I just wished i had a reliable memberbase, as i already have much to bid to my members. But they just still won?t show up

[icecube0045]

how do I "CHMOD" my files?

[yoyoyoyo]

Originally Posted by icecube0045

how do I "CHMOD" my files?

Files and directories on webservers may have three types of permissions:

1) read (`r')
2) write (`w')
3) execute (`x')

Each permission may be `on' or `off' for each of three categories of users:

1) the first digit refers to the file or directory owner
2) the second digit refers to other people in the same group as the owner
3) the third digit refers to all others (the world)

'chmod' or "change mode" is the UNIX way of changing file permissions. Basically CHMOD refers to setting the access privileges for a file, and you use an FTP client. Highlight the file that you want to change permissions for, and right click and select "Properties" or "Permissions" or "CHMOD" or "File Attributes" (depending on which FTP client you are using). Within each set of permissions (you, group, world) there are three permissions you can set: Read - Write - Execute. Therefore when you set the permissions on a file you must take into account 'who' needs access. The chmod command allows you to change the file permissions to allow only specific people to view your files and directories.

This is what CHMOD 755 looks like:



Most Perl Scripts should be set to 755. Most HTML files should be set to 644. And most data files that must be written to by a web server should be 666. The standard directory permission should be 755. Directories that must be written to by a web server should be 777. Your home directory should be 700. If you are operating a ~username type server, the public_html directory should be 777. (You may also need to open up the home directory to 755.) (It's typically a bad idea to chmod 777 any file, as it allows the world to replace the program with whatever they'd like).

Setting execute for a directory allows that directory to be read. That is, you can see what's in it. That is, if a user does not have execute permissions for a directory, when they attempt to view the contents of that directory it will return an error and not list the files in that directory.

side note: Any file name that starts with a '.' is invisible to the webserver when a directory list is generated (This is a quick and easy way to hide a file).

here is a quick CHMOD reference:

Number | Permissions
=================================================
0 | None - cannot read or write or execute
1 | Can execute, but cannot read or write
2 | Write-only, cannot read or execute (??)
3 | Writeable/executable
4 | Read-only, cannot write to or execute
5 | Read-only executable, cannot write to
6 | Readable Writeable file, but not executable (ie: text file)
7 | Readable Writeable Executable file - most programs are this

[icecube0045]

thank you yoyoyoyo you have been extremely helpful and I now have it uploaded and its working. Now im trying to figure out how to change the colors and the names and add catigories

[icecube0045]

In my vb cp i dont see add new template. This is all I see,

Style Manager
Search in Templates
Replacement Variable Manager
Download / Upload Styles
Find Updated Templates

[yoyoyoyo]

Originally Posted by icecube0045

In my vb cp i dont see add new template. This is all I see,

Style Manager
Search in Templates
Replacement Variable Manager
Download / Upload Styles
Find Updated Templates

click on the style manager link, and then in the drop down box on the right hand side where it says "all style options" you will see an option to "Add New Template" under "TEMPLATE OPTIONS"

or you can always just go to:

http://yoursite.com/forum/admincp/template.php?s=&group=&do=add&dostyleid=1

(assuming you are editing style ID #1)

[yoyoyoyo]

Originally Posted by icecube0045

OK, ive added the new template but when I try to add it to my nav bar, I dont see the option "nav bar". it was there before when I added the trader feedback ratings but its not there right now.

click on the "<< >>" button

[icecube0045]

When i try to open auction.php i get an error message that says "Warning: main(./includes/init.php): failed to open stream: No such file or directory in "my directory" on line 21. And I get a fatal error message. but the auction.pl works and the auctions page comes up and everything

[yoyoyoyo]

Originally Posted by icecube0045

When i try to open auction.php i get an error message that says "Warning: main(./includes/init.php): failed to open stream: No such file or directory in "my directory" on line 21. And I get a fatal error message. but the auction.pl works and the auctions page comes up and everything

You need to change the filepath in the template iframe section to match the filepath to your auction.pl file. Try this.. change the code in the template to look like this:

$stylevar[htmldoctype]
<html dir="$stylevar[textdirection]" lang="$stylevar[languagecode]">
<head>
	<!-- no cache headers -->
	<meta http-equiv="Pragma" content="no-cache" />
	<meta http-equiv="Expires" content="-1" />
	<meta http-equiv="Cache-Control" content="no-cache" />
	<!-- end no cache headers -->
	<title><phrase 1="$vboptions[bbtitle]">$vbphrase[x_powered_by_vbulletin]</phrase></title>
	$headinclude
</head>
<body>
$header
$navbar
<if condition="$bbuserinfo[userid]!=0">
<div align=center><iframe name="auction" ALIGN="CENTER" BORDER="0" FRAMEBORDER=0 HEIGHT=3000 WIDTH=100% MARGINHEIGHT=0 VSPACE=0 MARGINWIDTH=0 SCROLLING=0 src="http://yoursite.com/cgi-bin/auction/auction.pl"></iframe></div>
$foruminfo[forumfooter]
$footer

change the URL to match the URL to your auction.pl file

[icecube0045]

Originally Posted by yoyoyoyo

You need to change the filepath in the template iframe section to match the filepath to your auction.pl file. Try this.. change the code in the template to look like this:

$stylevar[htmldoctype]
<html dir="$stylevar[textdirection]" lang="$stylevar[languagecode]">
<head>
	<!-- no cache headers -->
	<meta http-equiv="Pragma" content="no-cache" />
	<meta http-equiv="Expires" content="-1" />
	<meta http-equiv="Cache-Control" content="no-cache" />
	<!-- end no cache headers -->
	<title><phrase 1="$vboptions[bbtitle]">$vbphrase[x_powered_by_vbulletin]</phrase></title>
	$headinclude
</head>
<body>
$header
$navbar
<if condition="$bbuserinfo[userid]!=0">
<div align=center><iframe name="auction" ALIGN="CENTER" BORDER="0" FRAMEBORDER=0 HEIGHT=3000 WIDTH=100% MARGINHEIGHT=0 VSPACE=0 MARGINWIDTH=0 SCROLLING=0 src="http://yoursite.com/cgi-bin/auction/auction.pl"></iframe></div>
$foruminfo[forumfooter]
$footer

change the URL to match the URL to your auction.pl file

Ok I just did that but the auction.php file still gives me that same error