EZ Shopper E-Commerce Store
128 CONCEPTS SOFTWARE

Copyright 2003 ©  128 Concepts All rights reserved

1.  Licence Agreement.
2.  Installation Notes.
3.  Notes on how to customize EZ Shopper.
4.  Company Contact Details.

1.	License Agreement for Evaluation Version
 
Before downloading EZ Shopper for evaluation you must read, understand and agree to this license before downloading EZ Shopper. This document helps to explain the extent of what is permitted by the user and what restrictions are in place.
 
Prices for Licenses:
 
Evaluation Restricted License: £0
FREE to all users.
 
Full License: £15.00
Full license to remove the various headers/footers containing words such as powered by EZ Shopper and copyright information.

APPLICATION - This agreement applies to the evaluation version of the SOFTWARE comprising scripts & related files and supporting documentation.
 
NOTICE TO USERS: 
This License Agreement herby states that use of EZ Shopper (THE "Software") provided with this agreement constitutes your acceptance of the terms. If you do not agree to the terms of agreement, DO NOT DISTRIBUTE, INSTALL AND/OR USE THIS SOFTWARE. USER'S ACCEPTING USE OF SOFTWARE IS CONDITIONED UPON COMPLIANCE BY THE USER WITH THE TERMS OF THIS AGREEMENT.
 
GRANT OF SOFTWARE LICENSE:
You are granted a license to use ONE copy of the version of this SOFTWARE on any single computer, which can be connected at any one point in time to an unlimited number of computers on one or more networks. 
 
RESTRICTIONS ON USE OF EZ SHOPPER:

You are permitted to:-
•	You can use the software on unlimited computers and operating platforms.
•	You can freely modify the graphics, structure and layout of EZ Shopper within your internal web site. You cannot distribute your modifications without prior consent to 128 Concepts and you must purchase a full license if you wish to remove all copyright text messages displayed. You cannot remove the copyright notices in the script files as they are sole property of 128 Concepts. 
•	Create applications from EZ Shopper if the application is original and provide a link to 128 Concepts.

You are not permitted to:-
•	Permit other individuals to use the software except under the terms of license given above.
•	To remove/modify any copyright notices found in footers/header of each script file unless you purchase a full license agreement.
•	Distribute source scripts, graphics, and documentation without prior consent from 128 Concepts. Full licensees will be granted such distribution of above materials without need to consult 128 Concepts for permission.
 
DESCRIPTION OF RIGHTS AND LIMITATIONS:

The SOFTWARE is owned and copyrighted by 128 Concepts Software. Your license confers no title or ownership in the SOFTWARE and should not be construed as a sale of any right in the SOFTWARE. This license is not transferable to any other hardware product or other company, entity or individual.
 
COPYRIGHT - The SOFTWARE is protected by copyright law. You acknowledge that no title to the intellectual property in the SOFTWARE is transferred to you. You further acknowledge that title and full ownership rights to the SOFTWARE will remain the exclusive property of 128 Concepts Software and you will not acquire any rights to the SOFTWARE except as expressly set forth in this license. You agree that any copies of the SOFTWARE will contain the same proprietary notices, which appear on and in the SOFTWARE.
 
UNAUTHORIZED USE - You may not modify the SOFTWARE or disable any licensing or control features of the SOFTWARE except as an intended part of the Software’s programming features
 
INSPECTION AND TESTING - You agree and acknowledge that you will thoroughly inspect and test the SOFTWARE for all of your purposes upon commencement of your use.
 
TERMINATION - You may terminate this Software Product License at any one time. In addition, without any prejudice to any other rights, this Agreement and the license granted hereunder will terminate automatically if you fail to comply with the terms and conditions described herein. 
 
MISCELLANEOUS - 128 Concepts reserves the right to modify the terms of the License Agreement at any time but most up to date copy of the License Agreement is available to download at your request. 128 Concepts reserves the right to modify the price subject to change without prior notice.
 
DISCLAIMER OF WARRANTY:
The Software is provided on an "AS IS" basis, without any warranty of any kind, including without limitation the warranties of merchantability, fitness for a particular purpose and non-infringement. The entire risk as to the quality and performance of the Software is borne by you. 
 
NEITHER 128 CONCEPTS SOFTWARE NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY OF THIS SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT, CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SUCH SOFTWARE, EVEN IF 128 CONCEPTS SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE. IN NO EVENT SHALL ANY THEORY OF LIABILITY EXCEED THE LICENSE FEE PAID TO 128 CONCEPTS SOFTWARE.
 
NO LIABILITY FOR CONSEQUENTIAL DAMAGES. IN NO EVENT SHALL 128 CONCEPTS SOFTWARE OR ITS SUPPLIERS BE LIABLE TO YOU FOR ANY CONSEQUENTIAL, SPECIAL, INCIDENTAL OR INDIRECT DAMAGES OF ANY KIND ARISING OUT OF THE DELIVERY, PERFORMANCE OR USE OF THE SOFTWARE, EVEN IF 128 CONCEPTS SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO EVENT WILL 128 CONCEPTS SOFTWARE LIABILITY FOR ANY CLAIM, WHETHER IN CONTRACT, TORT OR ANY OTHER THEORY OF LIABILITY, EXCEED THE LICENSE FEE PAID BY YOU, IF ANY. 
 
COMPANY CONTACT
 
128 Concepts PO Box 11236, Kings Norton, Birmingham, B30 1YA, United Kingdom.
web-site: www.128concepts.com  |  email: sales@128concepts.com

2.	Installation Notes

1. Upload the whole contents of the "MYSHOP" folder to the desired folder on your host server.

2. chmod the following:

   "./images" 		- chmod to 755 
   "./info" 		- chmod to 755
   "./backup"		- chmod to 755
   
3. Run the EZ Shopper installation script installer.php - note that by default it will check to see if you folder permissions are set correctly. If they are not set correctly, use some FTP software to change to file permission setting to 755. If successful, you can proceed to install EZ Shopper. You can stop the installation by answering 'NO' when it asks you to continue. During installation, any old previous database data will be destroy - it best to backup any data before continuing to run the installer script. It will create all the necessary tables and prepare the settings for you to use first time. After installation is successful, you can delete the installer script. This is necessary as a security precaution in the event that by accident you delete all the data.

3.	Notes on how to customize

HOW TO CUSTOMIZE EZ SHOPPER

After installation of EZ Shopper, the next step is to customize the configuration file for use with your host server. The configuration file is named ‘config.php’ and within is the parameters to customize for your host server

4 parameters you need to change are as follows:-

server - this is the host server - normally default to localhost. Otherwise, it is what your web hosting company has assigned you. Note please input server carefully as it can be case-sensitive.
user - this is your username - normally you can set this yourself. Otherwise, it is what your web hosting company has assigned for you. Note please input username carefully as it can be case-sensitive.
password - this is your password. -  Normally you can set this yourself. Otherwise, it is what your web hosting company has assigned for you. Note please input password carefully as it can be case-sensitive.
database - this is the sql database name.

NOTE: YOU MUST FILL IN THESE PARAMETERS, BY DEFAULT THEY ARE SET TO BLANK. MAKE SURE YOU FILL IT AS IT APPEARS ELSE CAN LEAD TO PROBLEMS LOADING IT.

Other parameters of significance within 'config.php'

$color - primary colour use for text/font colour display.
$highlight - primary colour use for text/font colour display.
$backcolor, $backcolor1 - colours used for table colour.
$min_cost - minimum cost for which shipping applies. If order is greater than value of $min_cost, then shipping be free.

$shipcost - the shipping cost value. If you not using world currency then the shipping cost value be for the country i.e. which is local for you. e.g. if your company is in United States of America then the shipcost be a value in US dollars and so on. Please be careful of different currencies as some countries have currencies where 1000 and 100 can have different currency values. e.g 1000 liras compare with 100 us dollars. 100 us dollars is more than 1000 liras. So be careful of the value and in what currency the value be set to.

$company - your company name.
$cline1,$cline2,$cline3,$cline4 - your company's address which includes city and postcode.
$items – if products exceed the value of $items, then paging mode is used.

NOTE: There are sql equivalents settings for company and company's address information.

$stockopt - this can be set to YES or NO. YES - refers to stock option mode. In stock option mode, when an order has been shipped, stocks levels be adjusted. NO - refers to stock option mode and no stocks will be deducted.

$usedata - this can be set to YES or NO. YES refers to EZ Shopper to use SQL settings data. NO refers to EZ Shopper using the standard parameters.

I would set $usedata to YES - as this permits the user to change the setting from any computer terminal, provided he inputs the security administrator password.

If the user wishes to set $usedata to NO. I suggest adding the line.

$wcurrency = "NO"; Also you need to set the base currency which can be in US dollars, UK Sterling, Euros, Japanese Yen, Canadian Dollars.

To set for the above currency you need to type the following line into the 'config.php'

$scurrency = "gbp" for UK sterling.
$scurrency = "usd" for US dollars.
$scurrency = "eur" for Euros.
$scurrency = "jpy" for Japanese Yen.
$scurrency = "cad" for Canadian Dollars.

$admin_name, $admin_mail, $admin_sales - these are header email information.
$style - this is the style setting. If set to 1 this is the style used for testing and should be used only by administrator. The layout is not so pretty but is there as an aid for testing.
If set to 2 this is default style most people will see on your site.

$site_info_url - location where you put your product information, any text files for company information, welcome information etc.

$usecat - This can be set to YES or set to NO. If you set to NO it will use default categories. If you set to YES, you can add your own categories. You need to create your own categories which can be done using the 'Add Menu' in the Administration Panel or in the file 'index.php'.

To use the administration panel, the setting for the administrator is as follows.

Username = admin
Password = 999

Type the word 'admin' without quotes in Username and '999' without quotes. This is standard setup. After you log in. I strongly recommend you update the password. You can do this by pressing 'Update Details' button after successfully logging in.

$phpcart - this is special additional feature built into EZ Shopper for those who wish only use the shopping functions and not any of browse, search functions. The sidebar is removed and the user will only see the header and footer displayed. The header is HTML file displaying your company header information. The footer is HTML file displaying your company footer information. Both files can be adapted. There are other header and footer files the user can customize.

$scurrency - This is base currency. See above for explanation.
$wcurrency - This is world currency and there is choice of up to 25. If no world currency is to be used, set it to 'NO' otherwise it can be set in settings manager which you can access after you logged in.
$conv1,$conv2,$conv3,$conv4,$conv5 - these are currency exchange rates for US, UK,EUR,JAPAN, CANADA currency. For example, the host site was based in Country A, then $conv1,$conv2...$conv5 are the exchange rates for 1 unit of currency of Country A into the relevant currency for US, UK,EUR,JAPAN, CANADA. For administrators it best to update the settings each day or at least every week. To get the latest currency exchange information I use the link www.xe.com which is currency exchange website. Try registering for their email service which they can send you daily updates. Then you can up-to-date figures which you can input into the settings manager.

$zone1,$zone2,$zone3 - these are shipping zone costs and the value is set by you. If you look at the checkout webpage, you will see a list of countries group into each zone. Although it not covers every country. I sure that most users can customize it by exchanging the files 'shop_checkout.php' and 'shop_sendorder.php' and 'shop_pay' for making changes. Embedded inside are the code that determines what country appears in what zone and at the bottom is code to display the countries. By careful changing them, you can add or change countries to your liking.

I strongly recommend the administrator researches with their postal service for estimated costs on posting to those countries in those zones and give a shipping zone value that reflects most accurate the cost to send to those countries. Make sure that the shipping cost is not too high but enough to cover your expenses for posting, handling etc. I think most online users know that it costs more to send overseas so they are willing to pay extra for services for sending overseas. Just be reasonable and not OVERCHARGE!!!!!!!!

Input information for your products, categories etc

In order to get your e-store running smoothly you need to add some products and add some stock records. The products for you e-store can be added executing the 'index.php' - one assumes that you inputted your username and password as this file is password protected and non administrators will be refused permission to use.

Once you have executed the 'index.php' script you will see a list of options. Choose the option for adding and you taken to adding web page. You will see a drop-down list with the following options.

Create products record
Create contacts record
Create stocks record
Create category record
Create stocks[user] record

Click on the first option and you be taken to web page for adding new products

There you will see a web page with some textboxes for you to input your products data. The textboxes are Item ID, Item Title, Item Description, Item Price. 

NOTE: Item ID is a numeric field and requires a numerical item id. Item Price is also numerical field. The Item Title, Item Description are alphanumeric. After you inputted your details. Press the Add Record button to save the record to your database. If at any time you wish to clear the details if you made a mistake, click on 'Clear' button.

Click on the second option and you be taken to web page for adding contacts

You will see once again a web page for text boxes for you to input your contacts data. The textboxes are Contact ID, Title, First Name, Surname, Address #1, Address #2, City, County, Post Code, Phone, Fax, Email.

NOTE: Contact ID, Phone, Fax are numerical fields. Phone and Fax can accept special characters such as spaces and dashes and brackets (). The rest of the fields are alphanumeric. Press the Add Record button to save the record to your database. If at any time you wish to clear the details if you made a mistake, click on 'Clear' button.

Click on the third option for adding stocks [non-user defined]

You will see once again a web page for text boxes for you to input your stocks data. The textboxes are Stock ID, Stock Item,
a pull down list containing default categories, Picture, Stock, Colour, Size.

Stock ID - this is the stock number id and should be identical to Item ID. 
Stock Item - this is the title for the stock item and should be exactly as the Item Title in the Products record. 
Category - this is a pull down list for you to select the category type.
Picture - this is your link for a picture file for the stock item.
Stock - this is a numerical number for number of stock of the item.
Colour - this is colour description for stock item.
Size - this is size description for stock item.

Press the Add Record button to save the record to your database. If at any time you wish to clear the details if you made a mistake, click on 'Clear' button.

Click on the fourth option for adding category

You will see once again a web page for text boxes for you to input your stocks data. The textboxes are Category ID, and Category.

Category ID - this is the category id number and is numerical.
Category - this is the user's defined category description

Press the Add Record button to save the record to your database. If at any time you wish to clear the details if you made a mistake, click on 'Clear' button.

Click on the fifth option for adding stocks [user defined]

You will see once again a web page for text boxes for you to input your stocks data. The textboxes are Stock ID, Stock Item,
a pull down list containing default categories, Picture, Stock, Colour, Size.

Stock ID - this is the stock number id and should be identical to Item ID. 
Stock Item - this is the title for the stock item and should be exactly as the Item Title in the Products record. 
Category - this is a pull down list for you to select the category type. N.B the items in the list will be those you created in option 4.
Picture - this is your link for a picture file for the stock item.
Stock - this is a numerical number for number of stock of the item.
Colour - this is colour description for stock item.
Size - this is size description for stock item.

The Create Menu 

This is a web page for creating tables for EZ Shopper. If you already executed the Installer Script then this step is not necessary. The create menu web page contains a series of options for the user to create various tables. A brief description is provided for each option.

Create products table - this will create the table for input of product records.
Create contacts table - this will create the table for input of contact records.
Create stocks table - this will create the table for input of stocks records (non-user defined/user-defined).
Create orders table - this will create the table for orders online.
Create users table - this will create the table for users - i.e. for logging in and logging out.
Create user log table - this will create the table for user logs - i.e. logging of user's log in and log out.
Create settings table - this will create the table for settings - i.e. for customizing EZ shopper style, layout etc.
Create history table - this will create the table for history - i.e. user's history of purchases etc.
Create customer orders - this will create the table for customer orders - this will hold customer orders (linked with history).
Create rating table - this will create the table for rating - this is used for most popular products.
Create user category - this will create the table for user categories.
Create customer reviews - this will create the table for customer reviews on products.
Create shipping orders - this will create the table for shipping orders.

The Delete Menu

This is a web page for deleting tables for EZ Shopper. The delete menu web page contains a series of options for the user to delete various tables. A brief description is provided for each option.

Delete products table - this will delete the table for products records.
Delete contacts table - this will delete the table for contacts records.
Delete stocks table - this will delete the table for stocks records.
Orders Delete Menu - this will take you to a webpage with options for deleting orders.
Delete users table - this will delete the table for users records.
Delete SETTING - this will delete the table for settings for EZ Shopper.
Delete HISTORY - this will delete the table for history records.
Delete CUSTOMER ORDERS - this will delete the table for customer orders.
Delete Rating - this will delete the table for most popular products.
Delete All Category - this will delete all category records.
Delete Single Category - this will delete single category record.
Delete Customer Reviews - this will delete the table for customer reviews.
Shipping Delete Menu - this will take you to a webpage for deleting shipping orders.

The Update Menu

This is a web page for updating records for EZ Shopper. The update menu web page contains a series of options for the user to update various records. A brief description is provided for each option.

Update products records - this will take you to a webpage which permits you to update a particular products record. It will list out all the products and you must type in the textbox the product id you wish to update. You be taken to another webpage where you can change the product details. Press the 'Update' button and the record be updated. 

Update contacts records - this will take you to a webpage which permits you to update a particular contacts record. It will list out all the contacts and you must type in the textbox the contact id you wish to update. You be taken to another webpage where you can change the contact details. Press the 'Update' button and the record be updated. 

Update stocks records - this will take you to a webpage which permits you to update a particular stocks record. N.B this is non-user defined category stocks record. It will list out all the stocks and you must type in the textbox the stock id you wish to update. You be taken to another webpage where you can change the stocks details. Press the 'Update' button and the record be updated. 

Update category records - this will take you to a webpage which permits you to update a particular category record. N.B this is for user defined categories. It will list out all the categories and you must type in the textbox the category id you wish to update.  You be taken to another webpage where you can change the category details. Press the 'Update' button and the record be updated. 

Update stocks[user] records - this will take you to a webpage which permits you to update a particular stocks record. N.B this is user defined category stocks record. It will list out all the stocks and you must type in the textbox the stock id you wish to update. You be taken to another webpage where you can change the stocks details. Press the 'Update' button and the record be updated. 

Update reviews records - this will take you to a webpage which permits you to update a particular contacts record. It will list out all the reviews and you must type in the textbox the product id and author you wish to update. You be taken to another webpage where you can change the reviews details. Press the 'Update' button and the record be updated. 

The View Menu

This is a web page for viewing records for EZ Shopper. The view menu web page contains a series of options for the user to view various records. A brief description is provided for each option.

View all products records – this allows you to view all products records.
View all contacts records – this allows you to view all contacts records.
View all stocks records – this allows you to view all stocks records.
View all orders records – this allows you to view all online orders records.
View all users records – this allows you to view all users records.
View all HISTORY records – this allows you to view all history records.
View all CUSTOMER ORDERS – this allows you to view all customer orders records.
View all RATING – this allows you to view all most popular products records.
View all CATEGORY records – this allows you to view all categories records.
View all REVIEWS records – this allows you to view all customer reviews records.
View all SHIPPING – this allows you to view all shipping orders records.

NOTE: The information will be presented in a table for you to view.

The Create Menu

This is a web page for creating database for EZ Shopper. The create menu web page contains option for the user to create a database. 

The user will see a webpage asking whether or not he/she wishes to create a new database. This action may be restricted by web hosting companies who assign you with 1 SQL/MYSQL database. Please check with your web hosting company on how to add extra database. If the action is not permitted, the command will fail due to intervention from web hosting company. If they permit you to add then a database call ‘mydata’ is created. You of course can change the name. Look for files call create_db.php and create_db1.php. Inside there is $db where you can amend to add a new database name.

The Delete Menu

This is a web page for deleting database for EZ Shopper. The delete menu web page contains option for the user to delete a database. 

NOTE: It is strongly recommended that you backup any critical database data using the backup utility. 

The backup files are tab delimited files which show the data. Although not in a format for you to reuse; it does make your task of data re-entry a tad easier. You are given the option to delete the database, if you answer ‘YES’ then procedure to delete the database will begin.

Information on all Administrators’ functions

This section describes all the functions for the administrator. 

•	Update and maintain settings – this function permits the administrator to change the settings for EZ Shopper; a list of available options is display with editable textboxes. The administrator updates the options he/she wishes to change and presses the Update button. This function is available in the index.php script and also when the administrator logs in
•	Email customers and contacts – this function permits the administrator to send single email or bulk email to contacts and customers. It’s very simple to use. You be taken to a webpage where you see two pull down lists. The first pull down list contains list of all contacts. The second pull down list contains list of all customers. The third pull down list contains 4 options for sending email. The 1st option is Contacts List Single Email where the administrator can send email to single contact. The 2nd option is Contacts List All Email where the administrator can bulk send email to all contacts. The 3rd option is Customers List Single Email where the administrator can send email to single customer. The 4th option is Customers List All Email where the administrator can bulk send email to all customers. All you have to do is to fill in the email content and add a subject heading. When you ready to send press the ‘Send Email’ button. You be taken to a webpage where you see action of post been sent. You will see an email confirmation shown on the webpage. For multiple emails you see a list of emails been sent. For single email you only see one email been sent.
•	View site statistics – the name suggests that this function lets the administrator see useful information regarding the site, database records etc. Another useful function is that it will automatically amend the number of online users. If a user exits without logging off, they remain as one of the users logged in. So when the administrator runs this function it should correctly amend the online figure.
•	View redundant orders – the name suggests that this function lets the administrator see number of redundant orders. Redundant orders are similar to the situation previous where users exit the browser in the middle of an order; it will leave traces of the order in the system. This function permits the deletion of such redundant orders.
•	View customer orders – the name suggests that this function lets the administrator sees all the customer orders/online orders. It shows the order in detail, providing links to view/amend the order status.

•	View all users/customers – a function for viewing all users/customers and their details.

•	Manage and Control Orders – the name suggests that this function lets the administrator sees all the customer orders/online orders. It shows the order in detail, providing links to view/amend the order status.

•	Backup all data files – the name suggests a function for backing up the database files. It is recommended that you do at least once a week.

•	Manage and control shipping – the name suggests a function for managing and control of shipping. One assumes that you can amend an order’s shipping status from this function.

Information on special PHPCart Mode

This function permits the EZ Shopper to disable most of it search, sidebar, categories functions, log in, log out functions. This permits the sidebar to be removed from the display and allows administrators freedom to experiment with their own store layout. 

The functions of viewing cart, adding to cart, checkout can be coded into the webpage using a button and the following code.

<a href = ./shop_addtocart?pid=xxx><img src = ./images/addtocart.gif width=32 height = 16 border = 0></a>

xxx – is the product id and addtocart.gif one assumes is the add to cart graphic.

<a href = ./shop_viewcart.php><img src = ./images/viewcart.gif width=32 height = 16 border = 0></a>

viewcart.gif one assumes is the view cart graphic.

<a href = ./shop_showitem.php?pid=xxx><img src = ./images/showitem.gif width=32 height = 16 border = 0></a>

xxx – is the product id and showitem.gif one assumes is the show item graphic.

<a href = ./shop_checkout.php><img src = ./images/checkout.gif width=32 height = 16 border = 0></a>

checkout.gif one assumes is the view cart graphic.

Information on all Users’ Functions

This section describes all the functions available for users of EZ Shopper. It is intended to be a guide.

•	Write a customer review – this function permits the user to write a customer product review. The customer can comment on a particular product; also can give the product a rating from 0 stars (lowest) to 5 stars (highest)
•	View customer reviews – this function permits the user to view all customer reviews for any product. The function will only let customer view reviews for a single product and not show all customer reviews.
•	Email a friend – this function permits the user/customer to email a friend regarding a particular product. The email message is fixed and will contain a link to the store and the desired product. The customer/user provides the friend’s email address and when he/she presses the ‘Send’ button – the email is sent to the friend.
•	View History – this function permits the user/customer to view their current/past orders history. Customers can see their orders, which include shipping status if the order is ready for shipping. It will show the order status as well. 
•	View User log – this function permits the user/customer to view his/her logging activities whilst visiting the E-Commerce Store i.e. EZ Shopper. It will show log in times, log out times, date the log in was made, browser type.
•	Update User Details – this function permits the user/customer to change/alter their user login password, hint, email address etc. The username cannot be changed.

Additional information for EZ Shopper

•	EZ Shopper has automated confirmation of an order if it is paid by Pay Pal. After the order has been processed by Pay Pal it should return to our special thank you page. Embedded in the code are instructions to automatically set the order status to payment received. Other payment agents yet have this function.
•	EZ Shopper will automatically check the quantity a customer inputs with the stock levels and if he/she inputs a quantity exceeding or less than one, an error message is displayed. If a particular product is out of stock, the add to cart button is disabled. Even if someone attempts to hardcode it using URL link, it will be rejected and an error message is displayed.
•	After the administrator has created a shipping order record and the stocks option is set. The stocks level will be automatically deducted. The Shipping Manager also permits stocks to be automatically updated in the event that an order has been returned.
•	EZ Shopper permits the use of five base currencies i.e. USA Dollars, UK Sterling, Euros, Japanese Yen and Canadian Dollars. Australian dollars is also option but it not currently setup on Pay Pal. Also EZ Shopper permits the EZ Shopper cart to display product items prices in chosen world currency. A flag and 3 digit currency code signify the use of world currency. At checkout, conversion takes place and the basket is converted into the store’s base currency. N.B The shopping cart will also display the converted basket’s totals. At checkout, shipping is calculated based on the shipping zone. If the basket’s total not exceeds the minimum shipping total, then shipping costs be added. If it exceeds, the shipping fee will be free. The same applies to shopping baskets using world currency. A conversion of the shipping zone cost be taken and the overall basket will be converted to base currency. Email confirmation is sent to the customer and administrator once a customer decides he wishes to place an order. The customer can also print an invoice receipt of the order before proceeding to payment step. The customer must choose the option of payment either Pay Pal or Nochex. Additional payment agents can be easily added in.
•	How does one add extra payment agents? – the answer is very simple but requires a degree of PHP scripting knowledge. In the file ‘shop_checkout.php’ there is instructions for display of payment agents. Its easy to add extra payment agents if you use <option = ‘XXXX’>XXXX’s description</option>. Here XXXX is a payment agent and XXXX’s description is short description. So if you wish to add the payment agent 2CheckOut you add the following line. <option = ‘2CheckOut’>2CheckOut</option>. The next part requires some research. In the file ‘shop_pay.php’ you see a developer’s note on how to add extra payment agent. You can follow the format for Pay Pal and Nochex. You need to visit the payment agent’s website and look at their Help or FAQ section on how to add a payment link. It should include all the necessary code. Modify this and add it to ‘shop_pay.php’ – you should now have successfully added a new payment agent.
•	I wish to add VAT (value added tax) How do I do it ? - this is a very common question most users will add and ask why does not EZ Shopper include it. This current version is the first prototype version of EZ Shopper and has many features which need refining. The process is simple. In the file ‘shop_showitem.php’ you can add extra code to do the VAT calculation. Look for the line that says Our Price – this is a good spot to add the code in. How do I do it if I not good at PHP programming. This section is for novices and I show you the steps.
•	I wish to add my own store news – How do I do it ? – Modify your news etc in the file ‘welcomes.txt’ in /info folder.

Sample VAT or Product Item Tax code

Step 1 Look for the line where you see if ($showform == “YES”) – this is where you can add the extra code.

$saletax = X; // X is the sales tax in UK it is 17.5% and in other countries it may be different. So X be 0.175 because 17.5/100 = 0.175.

$vat = $salestax * $price;
$vatval = number_format($vat,2); // converts to 2 decimal places.
$excvat = $price - $vatval;	   // price excluding tax/vat etc.

Look for the following code line – you may need to change it twice in 2 separate places.

</form></td><td><fontcolor=#FF0000><strong>
Our Price $currency$price!</strong></font></td></tr>";

</form></td><td><font color=#FF0000><strong>
Our Price ($wcurrency) $price!</strong></font></td></tr>";

Amend the lines so it now looks like this:-

</form></td><td><fontcolor=#FF0000><strong>
Our Price $currency$price! (w/o VAT/TAX:- $currency $excval </strong></font></td></tr>";

</form></td><td><fontcolor=#FF0000><strong>
Our Price $wcurrency$price! (w/o VAT/TAX:- $wcurrency $excval </strong></font></td></tr>";

•	Dealing with returns or cancelled orders ? – another question most users will ask is how to deal with cancelled orders or returns. The most easiest method is to add a section in the file ‘company.txt’ to include a section on returns or cancelled orders. The best way is to instruct the customer to send an email to the sales email address of your company with the following:-

Please include your order id, your full name and postal address. Also include the customer’s email so the administrator or company can respond to the customer. The email contents for the customer must include the above details. From this the administrator can update the customer order status to ‘order rejected’ and shipping status to ‘Terminated’ – if shipping order is terminated it should update the stocks if the stock option is enabled. The administrator will need to create an email informing the user that the order has been cancelled or company has received the returned goods. Another aspect which is outside the boundary of EZ Shopper is for the company to return payment. Nochex and Pay Pal offer sellers the option to refund. I cannot help users on this matter as it their responsibility.

•	I wish to upload my own product images? – yes you can upload your own product images to the images folder. When creating the stocks record, you will see a link call ‘Upload picture’ – this function permits the user to upload picture.
•	Can I add category picture to the Store Main Page? – yes you can and it simple to do. You need to upload the category picture to the images folder. I recommend a size dimension of 32 pixels x 32 pixels.

To add the category image, you need to update the code in the file ‘stores.php’ – add the line <img src =./images/cat.gif width=32 height=32 border=0> and append it to the section for category display. Remember you need to add it twice, once to section for fixed categories and once to section for user-defined categories. Both sections are easy to find with little patience in scanning the code.

•	I wish to modify EZ Shopper to my own specification? – Note EZ Shopper belongs and is copyrighted to 128 Concepts Software. You cannot reserve the rights to EZ Shopper or its code as been yours. You can make modifications to it as long as your web site promotes our company website and our product EZ Shopper. This policy is done by most companies and is the norm.
•	I wish to ask for technical assistance – How can I? – Technical assistance is in the form of our forum, users of EZ Shopper can share technical advice on how to resolve technical issues. News and product updates or developments will be posted in the forum. Any new developments will be announced. Also users may send email contact to technical email address at 128 Concepts.
•	Does EZ shopper have any limitations? – Yes. The current version does not support credit card payment, however future version may incorporate such a feature. With customer feedback, suggestions and advice, 128 Concepts can develop future versions, with possibility of language packs, wish list, and many new features. 128 Concepts welcomes any suggestion and welcomes users who submit modifications to EZ Shopper software; such modifications will enhance EZ Shopper and make future versions more reliable and to specifications that users want.

We thank you for your purchase of EZ Shopper and hope 128 Concepts and its development, sales, technical assistance can be of assistance if you wish to make enquiries, comments, suggestions or modifications.

4.	Company Contact

128 Concepts
PO BOX 11236
King's Norton
Birmingham
B30 1YA

web:     www.128concepts.com
email:   sales@128concepts.com (Sales)
         technical@128concepts.com (Technical Support)