#////////////////////////////////////////////////////////////// #//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 SHARED HOSTING 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 run VERY IMPORTANT VERY IMPORTANT the cron.html file http://www.yoursite.com/cron.html VERY IMPORTANT VERY IMPORTANT This is the which file activates all of the page refresh VERY IMPORTANT VERY IMPORTANT functions in order for the site to operate. This page, VERY IMPORTANT VERY IMPORTANT the cron.html page must be left open 24 hours a day VERY IMPORTANT VERY IMPORTANT everyday. Failure to have this page open in a web VERY IMPORTANT VERY IMPORTANT browser will cause the site to not funtion at all. VERY IMPORTANT VERY IMPORTANT It is highly recommended that you get at least a VERY IMPORTANT VERY IMPORTANT Virtual Dedicated Server for operating the script VERY IMPORTANT VERY IMPORTANT and thus eliminating the need for having the cron.html VERY IMPORTANT VERY IMPORTANT open 24/7 in a browser. 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 #5 ( Use the Filezilla FTP & PSPad Text Editor for this ) 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 = 60 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 There is a webpage designed to tell you what you servers PHP settings are: NOTE http://www.yourdomainname.com/phpinfo.php NOTE NOTE STEP #6 ( Use the Filezilla FTP & 7-ZIP Program for this ) *************** DO NOT USE THE GODADDY FTP PROGRAM IN THE HOSTING CONTROL PANEL!! ********** 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_4" 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 STEP #8 Run The Install Program from your web browser. NOTE: Select Create New Database!!!! Do not change the information that is already filled in the forms. Only input the information that is blank. http://www.yoursitedomain.com/admin/install.php NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE SOME SHARED HOSTING SERVERS WILL NOT ALLOW allow_url_fopen = On EVEN IF NOTE THE PHP.INI FILE SAYS IT IS, THIS MAY CAUSE ERRORS DURING THE INSTALL NOTE PROCESS TO APPEAR, BUT THE INSTALL PROCESS SHOULD STILL ABLE TO COMPLETE NOTE THE INSTALL AND DATABASE SETUP. 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 #10a 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 #10b OPTIONAL ON SHARED HOSTING ACCOUNT Many shared hosting accounts do not allow you to setup cronsjobs to run every minute if at all. But if you can set them up, It highly recommended that you do so. Setup cronjobs / scheduled tasks. There needs to be five 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 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 ( 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 ---------------------------------------------------------------- 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