#////////////////////////////////////////////////////////////// #//COPYRIGHT 2009 - 2010 Aaron Helmlinger ALL RIGHTS RESERVED// #////////////////////////////////////////////////////////////// License: You are given permission to place this script Ajax PHP Penny Auction v1.4 in use for a single website url. Permission is not granted to redistribute or commercially sell Ajax PHP Penny Auction v1.4 to any third party. For multiple site usage, additional license are only $49 per domain. All copyrights are to remain in place, with exception to the page footer copyright. We not be responsible for any losses that Client may or may not incur through the operation their Penny Auction Web site. We do not guarantee or claim to guarantee the monetary success of the Clients Penny Auction Web site. AJAX PHP PENNY AUCTION: version 1.4 Installation Technical Support If you need some help with the install, I am open to helping, just email or call during office hours using the info at the bottom of this README.txt file. However, I do make a living by installing the script, so my help will fall short completely installing the script for you without being compensated. ************* THIS README.TXT FILE IS FOR VIRTUAL DEDICATED SERVER INSTALLATION *************** * PLEASE NOTE: Ajax PHP Penny Auction v1.4 was design to operate most * effectively using a Virtual Dedicated Server (VPS) or better. Using A * Shared Hosting Account may result under performance of the script's * functionality affecting your business. If ellecting to use a Shared Hosting * Account, try to find one that has the MySQL databese locally hosted on * the same webserver and not located in seperated data center or database server. VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT After Install and Script setup, you will need to VERY IMPORTANT VERY IMPORTANT setup cronjobs / scheduled task inorder to activate VERY IMPORTANT VERY IMPORTANT all of the page refresh functions in order for the VERY IMPORTANT VERY IMPORTANT site to operate. Example cronjob commands can be seen VERY IMPORTANT VERY IMPORTANT below in STEP #15. They need to run every minute. VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT VERY IMPORTANT STEP #1 Write down and save for future use the License ID # you received During your script purchase process. You will be asked for this number during the install process. STEP #2 You will need a ftp ( File Transport Protocol ) program to upload your script to your webserver, A text editor for editing text file, Putty / SSH client for logging into your server as Super User to configure the server and a Unzip tool. You can download Filezilla, PSPad, 7-ZIP and a Putty client from the http://www.ajaxphppennyauction.com homepage. STEP #3 Purchase and aetup your Shared Hosting Account. *** Again not receommended to use this type of account STEP #4 Create a MySQL Database and write down for later use. Server Address - If database is located on the same server "localhost" may work. Database Name Username Password STEP #5a ( Use the Filezilla FTP, PSPad Text Editor for this, Putty Client ) Download your server's php.ini file. Depending on your server's configuration the php.ini file is ussually located in the main directory of your web server account. If there is no php.ini file on the webserver, you will need to create one. Use a text editor to change your server's php.ini file so that these variables listed below are present and set to these following values. Don't forget to reupload the changed php.ini file. If this file is not changed the script may not install or operate correctly. It will take a few minutes for the new setting to become effective, so do not immediately proceed to step #8 Also, if the script is to be installed on a server running php5, the php.ini file may need to be named php5.ini. register_globals = Off allow_url_fopen = On magic_quotes_gpc = On mysql.allow_persistent = Off mysql.max_persistent = 0 mysql.max_links = -1 mysql.connect_timeout = 5 max_input_time = 10 max_execution_time = 500 session.cookie_lifetime = 86400 display_errors = Off safe_mode = Off NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE On virtual dedicated servers, specifically Centos server from Godaddy.com NOTE There is master php.ini file that you can modify using a SSH / Putty Client NOTE You will need to login into your SSH account become the systems superuser. NOTE NOTE Login NOTE type> su - NOTE type> enter password <-- Do not type this left arrow info NOTE type> vi /etc/php.ini <-- This open the php.ini normally located in the etc directory using the file in the text editor. NOTE type> i <-- Allows you to insert text and type text, do not use number keypad. NOTE key> esc <-- This exits insert typing mode. NOTE type> :wq <-- Saves the php.ini file. NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE There is a webpage designed to tell you what you servers PHP settings are: NOTE http://www.yourdomainname.com/phpinfo.php NOTE NOTE STEP #5b Configure httpb.conf MaxClient Connection A Godaddy Virtaul Dedicated Server is setup to allow only 50 maxclient connections at once, this means that about 30-40 users can be on the site at one time. We need to incresse this setting to allow for more maxclient connections. If you are installing the script on a Non Godaddy Server you will need to check to see what the maxclient setting of the httpd.conf is set to and where it is located on the server. Note, the location of httpd.conf file may be located in a different location on non godaddy servers. NOTE If you set to many maxclients, it can stop the site from working jamming the cpu with too many cycles. For Godaddy Virtual Dedicated Server, We will set the maxclients to 150, which will allow aboutt 100 users to be on the site at once. To exeed this setting, you will need to get a Dedicated Server. Do not worry, you will not have more than 100 users on the site at once for a little while. To have 100 usrs on at once, you will need to have about 5,000 registered users. This is how you change the httpd.conf on Godaddy Virtual Dedicated Server NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE On virtual dedicated servers, specifically Centos server from Godaddy.com NOTE There is master httpd.conf file that you can modify using a SSH / Putty Client NOTE You will need to login into your SSH account become the systems superuser. NOTE NOTE Login NOTE type> su - NOTE type> enter password <-- Do not type this left arrow info NOTE type> vi /etc/httpd/conf/httpd.conf <-- This open the php.ini normally located in the etc directory using the file in the text editor. NOTE type> i <-- Allows you to insert text and type text, do not use number keypad. NOTE NOTE *On Godaddy VDS, there are two maxclient settings, both need to be changed to 150. NOTE NOTE key> esc <-- This exits insert typing mode. NOTE type> :wq <-- Saves the httpd.conf file. STEP #5c Restart Apache Web Server Under Services. NOTE: I DO NOT MEAN RESTART THE ENTIRE SERVER, JUST THE APACHE WEB SERVER SERVICE ONLY. NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE How To restart the apache webserver using Plesk control panel NOTE Login Into Plesk Control Panel NOTE Click "Home" link on left menu NOTE Click "Services Management" Icon NOTE Click "Green Dot With Swirling Arrow" to restart the Apache server NOTE STEP #6 ( Use the Filezilla FTP & 7-ZIP Program for this ) ********** IF THE SCRIPT DOES NOT WORK AND GIVES YOU ERRORS DO NOT KEEP DELETING OR UPLOADING IT, ************* THIS WILL NOT FIX THE PROBLEM, IT IS SERVER CONFIGURATION PROBLEM. ***************** JUST TRYING TO SAVE YOU TIME AND FRUSTRATION. Unzip the download file using 7-ZIP. Using Filezilla, upload all files and folders to your public website directory located on the your web server. Upload the folders and files inside the second "Ajax_PHP_Penny_Auction_v1_3" folder. Do not just upload "Ajax_PHP_Penny_Auction_v1_3" folder to the server. There should be 12 top level directories and about 200 files. Copy all file and directories to the server. STEP #7 ( Use the Filezilla FTP Program for this - Right Click on folder - Select File Permission - set to 755 - Recurse Subdirectory On) Make writable for your account user / owner: /cronfiles and subdirectories and files /uploaded and subdirectories and files /includes and subdirectories and files /admin and subdirectories and files /themes/default/ and subdirectories and files NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE On some virtual dedicated servers we have found that it is necessary to NOTE set the permission level to 777 inorder to make the site operate correctly. NOTE This especially tru for Godaddy.com servers. NOTE STEP #8 Run The Install Program from your web browser. http://www.yoursitedomain.com/admin/install.php NOTE: Select Create New Database!!!! Do not change the information that is already filled in the forms. Only input the information that is blank. STEP #9 (For security) Remove or rename install files from "admin" directory I usually put a " - " at the end of the php install.php --> install.php- install2.php --> install2.php- install3.php --> install3.php- install4.php --> install4.php- install5.php --> install5.php- STEP #10 Login into your Admin Panel http://www.yoursitedomain.com/admin/ a) It will ask you to setup your admin username and password. b) Next it will return to the blank login screen, log into your admin using the username and password you selected. c) Password protect directory again using .htaccess ( Optional ) Search Google For More Info STEP #11 ( Admin Panel For This) Update your Seller Account Info username - should be your website name ( NOSPACES ) address - info about your business, address, phone, etc. email, your paypal email ****** NOTE: The email address you enter here should be the PayPal email address that you will be using once the site is live. The test paypal email address should be added to the config.inc.php, see STEP 13 for more details. STEP #12 Setup Bid Packs and Create Auctions in the admin area. Configure Other Settings STEP #13 ***** DOWNLOAD FROM THE SERVER TO YOUR LOCAL COMPUTER: config.inc.php from the "includes" directory Set PayPal payments to sandbox test mode by setting "$PHPAUCTION_TESTMODE" & "$TEST_PAYPAL_EMAIL" variables in the config.inc.php using a text editor. Save the the config.inc.php file and reupload to your server's "include" directory. Visit https://developer.paypal.com/ to setup sandbox account. before making the site live: Set PayPal payments to live by setting "$PHPAUCTION_TESTMODE" variable to "no" in includes/config.inc.php. ***** See "PayPal Configuration Screen Capture" Directory to view settings for PayPal account. ****** NOTE: The email address you enter into the first user account you created in STEP #8 should be your live PayPal email address STEP #14 Setup a paypal account and get verified by them. ***** See "PayPal Configuration Screen Capture" Directory to view settings for PayPal account. ****** NOTE: The email address you enter into the Seller Account updated in STEP #11 should be your live PayPal email address that is set as your "Primary Email" in the PayPal Profile. STEP #15 Setup cronjobs / scheduled tasks. There needs to be six setup to run every minute in order for the site's refresh to function correctly. The cronjobs below are examples, they may or may not work on all virtual dedicated servers. We know they work on Godaddy Centos servers runing Plesk and Simple Control Panels. /usr/bin/wget -O - -q -t 1 http://www.yoursitesdomainname.com/cron.php>/dev/null 2>&1 /usr/bin/wget -O - -q -t 1 http://www.yoursitesdomainname.com/get_time2cron.php>/dev/null 2>&1 /usr/bin/wget -O - -q -t 1 http://www.yoursitesdomainname.com/get_time3cron.php>/dev/null 2>&1 /usr/bin/wget -O - -q -t 1 http://www.yoursitesdomainname.com/item_page_ajaxcron2.php>/dev/null 2>&1 /usr/bin/wget -O - -q -t 1 http://www.yoursitesdomainname.com/uniquecron.php>/dev/null 2>&1 /usr/bin/wget -O - -q -t 1 http://www.yoursitesdomainname.com/autobidder2cron.php>/dev/null 2>&1 STEP #16 ( Use the PSPad Text Editor or Content Editor in the Admin Panel for this ) Update website layout as needed, the templates that need changing are as follows. You can use the Content Editor located in the Admin area to change these files. *******HIGHLY RECOMMEND USING A TEXT EDITOR LIKE PSPad. global_ie.css global_not_ie.css tab_menu.php - CHANGE THE TABS LINKS HERE tab_submenu.php - THE "WELCOME" MESSAGE IS HERE category_menu.php - THE CATEGORY DROPDOWN MENU AND SEARCH ARE HERE themes/default/header.php.html - THE LOGO, LOGIN BOX & $99 ANNOUNCEMENT ARE HERE themes/default/footer.php.html - THE TWITTER, FACEBOOK, PAYPAL LOGOS ARE HERE themes/default/template_about_us_php.html thmese/default/template_autobidder_php.html themes/default/template_advanced_search.html themes/default/template_empty_search.html themes/default/template_auctions_no_cat.html themes/default/template_auction_paypal_php.html themes/default/template_browse_php.html themes/default/template_buybids_paypal_php.html themes/default/template_buybids_php.html themes/default/template_buying_php.html themes/default/template_change_details_php.html themes/default/template_complete_history_php.html themes/default/template_contact_us_php.html themes/default/template_feedback_php.html themes/default/template_forgotpasswd_php.html themes/default/template_friend_confirmation_php.html themes/default/template_friend_php.html themes/default/template_index_php.html themes/default/template_item_php.html themes/default/template_item_watch_php.html themes/default/template_live_auctions_php.html themes/default/template_passwd_sent_php.html themes/default/template_payments_php.html themes/default/template_privacy_policy_php.html themes/default/template_register_php.html themes/default/template_terms_and_conditions_php.html themes/default/template_upcoming_auctions_php.html themes/default/template_user_login_php.html themes/default/template_yourbids_php.html themes/default/template_yourfeedback_php.html includes/live_and_upcoming_auction.inc.php mail_endauction_youwin_nodutch.EN.inc.php - THIS IS THE EMAIL SENT TO THE AUCTION'S WINNER usermail.EN.inc.php - THIS IS THE EMAIL SENT TO THE NEWLY REGISTERED USER FOR EMAIL CONFIRMATION ---------------------------------------------------------------- Enjoy your site and make a ton of cash. If you need help call the Help Desk at 1-281-652-8225 Mon-Fri 10AM - 5PM EST. or email helpdesk@ajaxphppennyauction.com