Location: PHPKode > scripts > Free PHP Shopping Cart > FPHPSC/READ_ME.txt
//////////////////////////////////////////////////////////////////////
// The freebert.com Free PHP Shopping Cart:
// Version 0.80 - July 14th, 2009
// License / Terms of Use:
// Free to use, edit & customize, so long as the freebert.com logo, 
// the 'Powered By The Free PHP Shopping Cart' text & links 
// remain displayed on the bottom of every visable shopping cart page. 
// Redistribution in whole or in part of any page or function within 
// the freebert.com Free PHP Shopping Cart is strictly forbidden
// without the express written consent from freebert.com.
// Copyright (c) 2007 - 2009  by Colin Burke - freebert.com
// Contact: hide@address.com
// Support: http://www.freebert.com/Wiki/index.php/FPHPSC
// NOTE: If you want a cart script package with more features like
// customer accounts, database integration, administration section,
// online customer orderstatus section and more, OR
// if you simply want to legally remove the logo & links and
// continue to use the freebert.com Free PHP Shopping Cart
// you may do so by buying a domain license for the freebert.com
// Deluxe PHP SQL Shopping Cart Script. For details go to:
// http://www.freebert.com/Products/DeluxePHPSQLShoppingCart/ 
//////////////////////////////////////////////////////////////////////

This program is freely 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.

The freebert.com Free PHP Shopping Cart Offical READ_ME.txt
Version 0.80 - July 14th, 2009

Contents:
1) - License Info
2) - Minimum Requirements
3) - Downloading the latest version of the Free PHP Shopping Cart
4) - Uploading the Free PHP Shopping Cart to your server
5) - Configuring The Free PHP Shopping Cart to run on your server
  a) - General Settings
  b) - Payment Options
  c) - Payment Mods
6) - Customizing The Free PHP Shopping Cart to better match your site's look & style
7) - Adding items to the shopping cart (Add To Cart Buttons)
  a) Adding Single Items
  b) Adding Multiple Items
8) - Additional Support
9) - Upgrade Instructions
10) - Update History

1) - License Info
The FreeBert Free PHP Shopping Cart package is free to use, with the condition that regardless of any changes you make to the code, you keep the FreeBert 'FB' link and logo visible on the bottom of every page within the package. You are forbidden from reselling and / or redistributing the FreeBert Free PHP Shopping Cart package in whole or part without express written permission from freebert.com.
NOTE: If you want to legally remove the logo & links and continue to use the freebert.com Free PHP Shopping Cart you may do so by buying a domain license for the freebert.com Deluxe PHP SQL Shopping Cart Script. For details go to: http://www.freebert.com/Products/DeluxePHPSQLShoppingCart/ 

2) - Minimum Requirements
The FreeBert Free PHP Shopping Cart only requires a PHP enabled server with access to session variables activated.  Most PHP servers are configured to allow the use of session variables.  If you are not sure if your PHP server is configured to allow the use of session variables, please contact your server administrator / hoster.

3) - Downloading the latest version of the Free PHP Shopping Cart
Make sure you have the very latest version of the Free PHP Shopping Cart - you can check the latest version available at:
http://www.freebert.com/Products/FreePHPShoppingCart/
If you do not have the most up to date version of the Free PHP Shopping Cart, you can download it from that same page.

4) - Uploading the Free PHP Shopping Cart to your server
Once you have downloaded and unzipped your copy of the Free PHP Shopping Cart, you need to upload it to your server.  Create a directory on your server for the Free PHP Shopping Cart pages to go (usually in the root directory of your site domain)  For example, you could create a subdirectory called FPHPSC on your root directory, which in the URL box of a browser would result in: http://www.youdomain.com/FPHPSC/
Keep track of what directory you upload to ('/FPHPSC/' in the above example), you will need that when configuring the package on your server.

5) - Configuring The Free PHP Shopping Cart to run on your server
Once you have uploaded all the Free PHP Shopping Cart files to a directory on your web server, you are ready to configure the package to run on your server.  To do so, you will need to edit the Local_Settings.php file in the cart script's root directory (if you uploaded your cart files to http://www.youdomain.com/FPHPSC/, the script root directory would be '/FPHPSC/').  In the Local_Settings.php file, you will see there are several settings that can be set, grouped into a couple of sections.

a) - General Settings - The general settings relate to the general setup of your cart script:
$Site_Domain - this should be the full domain of the root of your site
Example: 'http://www.freebert.com/'
Tip: be sure to end your domain with a '/'
$Site_Title - self explanatory
$Site_Script_Root_Directory - the name of the directory the script files reside in.
Example: if you uploaded the script files to http://www.youdomain.com/FPHPSC/, set Site_Script_Root_Directory = 'FPHPSC/' 
Tip: be sure to end your Site_Script_Root_Directory with a '/'
$CSS_Filename - the name of the CSS file you want the script to use.  Enter the title of the file only, and be sure that that file exists in the /css/ folder in your script directory.  The package includes 2 default CSS files in the css directory, called WhiteBack.css and BlackBack.css.  Try switching between these two to change the basic color scheme of your site.
$Session_Prefix - a short prefix to add to session variable calls - if you don't understand this leave it as FPHPSC_
$Currency_Symbol - the symbol you want displayed to represent the cart currency (such as '$', '£', etc)
$Currency_Code - they code you want displayed to represent the cart currency (such as 'USD', 'GBP', etc)

b) - Payment Options - The Payment Options section allows you to choose which of the installed payment mods are active on your site.  Enter a 1 beside the option to wish to activate, enter a 0 (zero) beside the option(s) you wish to de-activate.  By default, all payment options are activated.

c) - Payment Mods - The Payment Mod Settings section allows you to configure each of the active payment methods with your personal info.  
i) - For the PayPal option, you need to enter your paypal account email address (so paypal knows who to send the money to), as well as the official PayPal currency code you wish to use (such as USD, CAD, GBP, etc)
ii) - For the Money Order option, you need to enter info on who the money order should be made out to (should match the name on the bank account you intend to cash the money orders at), as well as the address you want the Money Order payments to be mailed to. 
iii) - For the Phone order option, you need to enter the phone number you want your customers to call in their sales to, as well as an additional field for giving extra instructions to your customers (such as calling hours, etc)

6) - Customizing The Free PHP Shopping Cart to better match your site's look & style.
There are a number of ways you can customize the look of your Free PHP Shopping Cart, to better blend the cart pages in the basic look & style of the rest of your site.  Firstly, you can choose an alternate .CSS file (in the Local_Settings.php file) to change between looks of your site. Alternatively you can edit the active .CSS file to change specific elements, color schemes and other visual properties. The cart package contains two files, Overall_Header.php and Overall_Footer.php (located in the script's /inc/skin/ directory) that are included in every visible cart page. They are a good place to add site logos and links to help the cart fit seamlessly into your site's main design. Finally, if you are PHP savvy, you can edit the actual codes and functions in the cart pages, taking complete control of the look, feel and function of your cart.  Be careful if/when editing PHP pages - a single misplaced quote or semi-colon could stop the functioning of your entire cart!


7) - Adding items to the shopping cart (Add To Cart Buttons)
You can place HTML code on any type of webpage (HTML, HTM, ASP, PHP, etc) to add items to the shopping cart for your customers to buy.  You can add single items, one at a time, or multiple/batch items to your cart.

a) Adding Single Items - To add a single item to your cart; use a form like the one below:

<form method="post" action="http://www.mydomain.com/FPHPSC/ShoppingCart.php">
  <input name="Title" type="hidden" value="$5 Donation With Shipping" />
  <input name="SerialNum" type="hidden" value="5DollarDonationWS" />
  <input name="Price" type="hidden" value="5.00" />
  <input name="Shipping1" type="hidden" value="1.00" />
  <input name="Shipping2" type="hidden" value="0.50" />
  <input name="cmd" type="hidden" id="cmd" value="1" />
  <input type="submit" name="Submit" value="Add To Cart" />
</form>

Tips: 
-all fields are mandatory, be sure to enter something into all the value fields
-make sure the action = the full URL to the ShippingCart.php file located on your server
-make sure the method = "post", NOT "get".
-make sure cmd = 1 for adding single item only
-make sure each different item has a different / unique SerialNum
-Shipping 1 refers to the shipping for quantity = 1 of that item
-Shipping 2 refers to additional shipping amount for each quantity over 1

b) Adding Multiple Items - To add multiple items to your cart with the click of 1 button, use a form like the one below:

<form method="post" action="http://www.mydomain.com/FPHPSC/ShoppingCart.php">
  <input name="Title0" type="hidden" value="$1 Donation With Shipping" />
  <input name="SerialNum0" type="hidden" value="1DollarDonationWS" />
  <input name="Price0" type="hidden" value="1.00" />
  <input name="Shipping10" type="hidden" value="1.00" />
  <input name="Shipping20" type="hidden" value="0.50" />
  <input name="checkbox0" type="hidden" value="1" />

  <input name="Title1" type="hidden" value="$2 Donation With Shipping" />
  <input name="SerialNum1" type="hidden" value="2DollarDonationWS" />
  <input name="Price1" type="hidden" value="2.00" />
  <input name="Shipping11" type="hidden" value="1.00" />
  <input name="Shipping21" type="hidden" value="0.50" />
  <input name="checkbox1" type="hidden" value="1" />
  
  <input name="Title2" type="hidden" value="$3 Donation With NO Shipping" />
  <input name="SerialNum2" type="hidden" value="3DollarDonationWNS" />
  <input name="Price2" type="hidden" value="3.00" />
  <input name="Shipping12" type="hidden" value="0.00" />
  <input name="Shipping22" type="hidden" value="0.00" />
  <input name="checkbox2" type="hidden" value="1" />

  <input name="Batch_Count" type="hidden" value="3" />

  <input name="cmd" type="hidden" id="cmd" value="5" />
  
  <input type="submit" name="Submit" value="Add To Cart" />
</form>

Tips: 
-all fields are mandatory, be sure to enter something into all the value fields
-make sure the action = the full URL to the ShippingCart.php file located on your server
-make sure the method = "post", NOT "get".
-make sure cmd = 5 for adding batch / multiple items only
-Shipping 1 refers to the shipping for quantity = 1 of that item
-Shipping 2 refers to additional shipping amount for each quantity over 1
-Make sure each field name ends with a number (starting at 0 for the first item) as in example above
-Make sure to include the field Batch_Count which lets the cart know how many items to process
-Make sure to include the field checkbox for each item - a value of 1 will add the item, a value of 0 will ignore / skip the item.  This last field is useful if you want to display a number of products in a list on a page - your customers can use a checkbox form element to choose which items they want to add to the cart all at once.  When the form is submitted to the cart, the cart will process all items in the list, and only add the items with a value of 1 for checkbox. Thus, in the example code above, although 3 items are being passed to the shopping cart's add batch function, only "My First Item Title" and "My Third Item Title" will be added to the cart.

8) - Additional Support
Additional support for the freebert.com Free PHP Shopping Cart can be found in the freebert.com Support Wiki:
http://www.freebert.com/Wiki/index.php/FPHPSC

9) - Upgrade Instructions
To upgrade from V0.70 to V0.80:
No changes were made to the header/footer files, or the css files.  As such, to upgrade, we suggest making a copy of your header,footer,css & local settings files.  Then do a fresh install of the latest version.  Once installed, copy over the new files your old css,header,footer files.  Since the new Loacl_Settings.php file has a few additional fields over the old version, you will need to open your saved copy of your old local settings, and fill in the fields in the new Local_Settings.php - notice the new Currency fields, update as required.  Upload and you are done.

To upgrade from V0.60 to V0.70:
There were changes made to the Local_Settings.php file, the files in the inc/functions folder, inc/payment_mods, & public cart pages (ShoppingCart.php, ChoosePayment.php, MakePayment.php)  No changes were made to the header/footer files, or the css files.  As such, to upgrade, we suggest making a copy of your header,footer,css & local settings files.  Then do a fresh install of the latest version.  Once installed, copy over the new files your old css,header,footer files.  Since the new Loacl_Settings.php file has a few additional fields over the old version, you will need to open your saved copy of your old local settings, and fill in the fields in the new Local_Settings.php - notice the new Currency fields, update as required.  Upload and you are done. 

10) - Update History
The following is brief summary of changes between each version of this script:
V0.80: July 14th, 2009
- There were minor changes made to all pages (changing http_post_vars to POST)
- There were minor changes made to the local settings and PayPal functions pages
-> These were made to allow the PayPal currency code setting to be made via the local settings page.
- Minor chages made to Read_ME.txt file

V0.70: December 11, 2007
-Added support for changing Currency used by cart Symbol ($) and Currency Code (USD) in Local_Settings.php & the files in the inc/functions folder, inc/payment_mods, & public cart pages.
-Fixed bug: redundant PayPal Email Account setting in PayPal Payment Mod deleted - Account is properly set via Local_Settings.php
-Minor changes made to cart html code
-Minor changes made to Read_ME.txt


//////////////////////////////////////////////////////////////////////
// The freebert.com Free PHP Shopping Cart:
// Version 0.80 - July 14th, 2009
// License / Terms of Use:
// Free to use, edit & customize, so long as the freebert.com logo, 
// the 'Powered By The Free PHP Shopping Cart' text & links 
// remain displayed on the bottom of every visable shopping cart page. 
// Redistribution in whole or in part of any page or function within 
// the freebert.com Free PHP Shopping Cart is strictly forbidden
// without the express written consent from freebert.com.
// Copyright (c) 2007 - 2009  by Colin Burke - freebert.com
// Contact: hide@address.com
// Support: http://www.freebert.com/Wiki/index.php/FPHPSC
// NOTE: If you want a cart script package with more features like
// customer accounts, database integration, administration section,
// online customer orderstatus section and more, OR
// if you simply want to legally remove the logo & links and
// continue to use the freebert.com Free PHP Shopping Cart
// you may do so by buying a domain license for the freebert.com
// Deluxe PHP SQL Shopping Cart Script. For details go to:
// http://www.freebert.com/Products/DeluxePHPSQLShoppingCart/ 
//////////////////////////////////////////////////////////////////////
Return current item: Free PHP Shopping Cart