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!

[yoyoyoyo]

I was going to call this vBay, but decided that vb.org didn't want you know who breathing down their necks

INSTALLATION OPTIONS:

This hack offers 5 (actually 6) different options of auction scripts for you to play with:

1) First is a version of EveryAuction that I have modified. It is basic looking but has alot of features. I purposely made the layout bare to match any forum, and you can control the look and feel with the style tags. You can also edit the html within the config.pl and auction.pl files to add, change the tables to suit your needs. Both files are heavily commented, so it should not be hard to find your way around them. It should be fairly easy to add additional features as needed, such as feedback and Accounting (if you wish to charge for auction listings, etc.), however I have left the accounting end of the script off of my version (though you will see a link to it in the admin area- this is in case you want to add it in yourself). You can find more addons at the everysoft addon database (URL BELOW).

2) If you are interested in starting from scratch and adding all of your own addons yourself you can use the second option, which is the original EveryAuction script,which you can grab from

PHP Code:

http://prdownloads.sourceforge.net/everyauction/everyauction_153.zip 


and then go to the addon database and pick and choose which files best suit your needs. It's all very easy, and you should not be intimidated by the fact that it is a perl script, since in many ways perl scripting is very intuitive especially if you are familiar with html and javascript standards.

3) The third option is to try a "new" version of EveryAuction that has been developed by people other than the author: EA 1.7, and it is available at

PHP Code:

http://www.bsmp.com/ea17/installingea17.html 


4) The fourth option is to run the eAuction script (which in turn is also a modified version of the EveryAuction script). This script has a few extra features, however it is harder to modify since it has already been modified quite a bit. It still can be done, but you will have to make sure not to cross any variables. This script is setup for multi-language support, and already has german language support built in. You can find the eAuction script at:

PHP Code:

http://www.everyscript.de/ 


5) Download the attached ezauctgn.zip file to allow your users to create their own individualized auction sites that you host! the Easy Auction Site Generator - uses EveryAuction from EverySoft to offer Auction Site Hosting, modified with more features and abilities. After you install this script at your site, you offer your guests the ability to create their own Auction Sites. Then link the template iframe to your easy auction's index.html page (be sure to follow the instructions enclosed in that zip file on which files to edit and how to edit them). Each auction site can be tailored and the owner may specify the following:

• choose the color scheme for the auction site
• define the directory where closed auctions will be moved
• define the directory where registration information is kept
• define "sniper" protection period (how many minutes past the last bid to hold auction).
• allow users to post items
• select file locking
• select the categories to include in the auction

Please see THIS post for more information.

6) There is another option, and that is to use the EveryAuction DB file found at everysoft, which is a MySQL version of the EveryAuction script.

INSTALLATION:

- make sure that your server supports perl scripts, and is running at least Perl 5.6.0 or greater. Notice that the script requires Perl 5.6.0 (or higher) !! I don't know whether this can run on a server that has under Perl 5.5.x If the script does not work for you then try placing the script in a subdirectory of your cgi-bin directory. Edit the top of the script to point to perl. The current version of perl is 5.8.X, so most servers should not have a problem with this if they offer perl/cgi access.

#!/usr/bin/perl This must point to the Perl version on your server. If you don't know it, ask your host or run info.cgi that comes included in the zip on your server to get it. In most cases #!/usr/bin/perl or #!/usr/bin/perl5 works OK. If you do not have Perl installed on your server all is not lost! You can try a file called perlsp that provides an ASP/PHP/JSP like environment for Perl on all servers, dedicated or virtual, with everything that you expect from a web programming environment (and before only knew from PHP or ASP)

PHP Code:

http://2n-com.de/perlsp/ 


.

- Follow the install instructions and make sure that the files are CHMOD'ed properly.

- To add your own categories slook at the top of the script in the config area of the script that tells you how to configure them. The script is well-documented, so just read the areas that are comments and make the changes noted.

EDIT THE STYLESHEET & HTML

It is not necessary, but you can change the style to match the look and feel of your auction by searching for the STYLE tags and edit the area inbetween to match the CSS of your forum. You can alternately link to any style sheet on your site, just as you would any other php or html page on your site. You can further edit the html parts of the auction.pl file, such as the tables, etc. to any layout you want, so if you are a layout/html wizard then you can customize the front end of this script easily, just be sure to preserve the continuity of the functionality in the process.

If you have multiple styles/skins that is not a problem, but you must have one auction.pl file for each skin, and have each skin point to a different file. Edit each one (between the style tags) to be the same style as your vbulletin skin. You can rename the file with no problem. You can call it auction1.pl, auction2.pl, etc. (or you can name them vbulletindefault_auction.pl it doesn't matter as long as you keep track of which is which) and add different templates to each style, with each one pointing to the proper auction.pl file for that style. Just keep all of the auction.pl files in the same folder and they will all pull data from the same auction database. You must keep them in the same folder as each other, otherwise each style will have different auctions! Also be sure to edit the part of the config area that asks you to define the scripts name.

There are also certain areas that you may want to change to suit your needs/layout, so don't be afraid to edit the html, just be sure to save backups of everything.

If you do edit your own auction.pl file (spiff up the html, etc.) and feel like sharing, PLEASE feel free to upload it to this thread!

ADD-ONS

For more addons to this script you can go to:

PHP Code:

http://forum.everysoft.com/cgi-bin/codepost.pl?action=listcategories&product=EveryAuction+1.5x 


NOTE: Many of the addons at that site need tweaking to work with each other, and many do not seem to work at all, and others lead to error 404 files (file not found) but it is still a very flexible script and you the site is a great resource to help you edit EveryAuction to suit your needs. Just about every auction feature you can think of has been integrated in to this script at one time or another to a degree.

LONG IFRAME ISSUE

NOTE: The only way that I could figure out to effectively manage to pull the output of the perl script in to a vbulletin template is with an iframe. The drawback to an iframe being that it does not resize with the amount of data that it pulls in, so if the page is really long and the iframe is too small then the result is that the iframe will develop annoying scroll bars, which are very ugly, messy and undesirable. To counter that I had to create an iframe that was very long, so there will be a bit of extra white space between the bottom of the auction content and the footer of your forum page. If anyone can come up with a better way to accomplish this, or to pass perl variables on to a php page then please post to the release thread of this hack at vbulletin.org.

Before you decide the page is too long, and decide just to simply go ahead and reduce the iframe, try posting a test auction, with a long description and a picture, and you will see why I decided the iframe needed to be that long, however of course you can always reduce the size as needed if you decide it is still too long.

NOTE: One way to avoid this issue is to add the same header and footer to your auction.pl (in the areas that they provide for that- just read the html) and style your <style> tags to be the same as your forum, and then just simply link people to your auction.pl file instead of your auction.php file. This way your header and fiiter will dynamically resize with your auction listings, and then your header can simply link them back to the forums! Just be sure to keep the auction navigation links intact or nobody will be able to find their way around your auctions.

TROUBLESHOOTING:

If you are getting errors it is probably one of these:
1) Path to directories (basepath) not set correctly
2) File permissions not set correctly
3) Server does not allow executable perl files with write permissions, or any files CHMOD'ed to 755
4) Template name not spelled correctly, or capitalized instead of small letters: auction

Some servers will also let you run a .pl or a .cgi script from any folder, so if you are STILL getting errors at this point then try uploading the folder named 'auction' to your forum root directory, and then change your config area of the auction script accordingly. If that works better then change the file path in the template to point to that directory instead of your cgi-bin directory. In fact, that is how I originally wrote the instructions, but realized that some people who can't run perl scripts from any directory other than the cgi-bin and would be out of luck, so by default I decided to tell everyone to put it in the cgi-bin directory, but as I mentioned that is not necessary in many cases. If the file paths are correct, and the files are chmodd'ed correctly and it is still not working then it most likely is a server issue, so check to make sure that your server will allow you to run executable cgi scripts with 755 CHMOD.

NOTE: If you get an error message like the one attached then you don't have the file paths set properly in the auction.pl file. The script creates the new category folders based upon the permissions you give it when CHMOD'ing it, and also based on what you have set as a basepath in the script. The folders are automatically created when the script is run the first time and the script can't create the folders it needs in the right place if the basepath is set incorrectly, so it can't find them, and thus the error.

The simplest way to fix this is to find the basepath to your 'cgi-bin/auction' directory, and the easiest way to do that is to use the info.cgi file that is in your cgi-bin/auction directory (and comes with this hack), is by typing in this address in to your web browser:

http://yoursite.com/cgi-bin/auction/info.cgi

(of course substitute "yoursite.com" with the name of your site, but keep the rest the same)

Now look in the area where it says: "SCRIPT_FILENAME" and take note of the URL that follows it on the same line. It should look something like:

/home/yoursite/public_html/cgi-bin/auction/info.cgi

Chop off the end (the info.cgi part) and voila, there is your filepath that you need to put in the area of auction.pl that says:

# The Base Directory.  We need an
# absolute path for the base directory.
# Include the trailing slash.  THIS SHOULD
# NOT BE WEB-ACCESSIBLE!
# **CHANGE THIS TO SUIT YOUR SERVER**

$config{'basepath'} = '/home/yoursite/public_html/cgi-bin/auction/';

(color and bold for emphasis)

If you STILL get errors, after you make sure that all of the above is correct then it could also be the case that your server simply does not allow executable files to have write permissions.

END NOTE

NOTE: I did not write the core of this file, it is based on a GNU public license file, and I added the hacks found online, and also tweaked a few of the subroutines as I saw fit, so if the auction scripts included with this file do not work or give you errors then I suggest editing your own version of EveryAuction to suit your needs. I will not give support for the EveryAuction script, but I will be happy to help with the integration of the script with vBulletin, as it pertains to this script, via the support thread at vBulletin.org.

[RichieBoy67]

OUTSTANDING!!!!!!!

I have been wiating for something like this!!!!! awesome! Thanks

[icecube0045]

Originally Posted by yoyoyoyo

I was going to call this vBay, but decided that vb.org didn't want you know who breathing down their necks

Has anyone installed and tried this yet?

[RichieBoy67]

I am doing the install right now... looks pretty straightforward so far but I am getting the following error when running the test script

PHP Code:

Error:
Category directory computer could not be opened 


I am almost certain it is a path issue so probably no big deal...

[yoyoyoyo]

Originally Posted by RichieBoy67

I am doing the install right now... looks pretty straightforward so far but I am getting the following error when running the test script

PHP Code:

Error:
Category directory computer could not be opened 


Delete the folder "auctions" in the cgi-bin folder and create a new one.

Then re-upload the contents of the "auctions" folder without actually uploading the folder.

EDIT: Actually, it IS a path issue- see the top post. I was able to replicate this error if the auction.pl script does not have the basepath setting at the top of the config section set properly. There are only a few settings to worry about, so read the script thoroughly- it is well documented and easy to understand.

An easy way to find you file path settings is to go to the info.cgi file and look for the path it says under "SCRIPT_FILENAME" and that will display your file path.

the URL to your info.cgi file will be something like this:

http://yoursite.com/cgi-bin/auction/info.cgi

Look at the "SCRIPT_FILENAME" setting display and it will look something like:

/home/yoursite/public_html/cgi-bin/auction/info.cgi

just cut off the info.cgi from the end and there is your needed file basepath!

paste that info in here:

$config{'basepath'} = '/home/yoursite/public_html/cgi-bin/auction/';

[RichieBoy67]

I'm still getting the same error..





Thanks for the support!!

[RichieBoy67]

Isn't

PHP Code:

construct_nav_option('Auction Admin', "../cgi-bin/auction/admin.pl", '<br />');
        construct_nav_option('Contact Auction Members', "$vboptions[bburauction.pl?action=contact, '<br />');
        construct_nav_option('Registration Report', "../cgi-bin/auction/auction.pl?action=readreg", '<br />');
        construct_nav_option('Auction Category Listing', "../cgi-bin/auction/auction.pl", '<br />');
        construct_nav_option('Closed Auctions', "../cgi-bin/auction.pl?action=closed", '<br />');
        construct_nav_option('System Info', "../cgi-bin/auction/info.pl", '<br />');
        construct_nav_group('Auctions'); 


supposed to have " " instead of ' ' ????

[MP3]

nice

[Koutaru]

I may try to install this a bit later :3 Thanks!!