Setup instruction

Setup Instruction
MidiCart PHP Shopping Cart

MidiCart PHP is a complete "easy to use and setup" e-commerce solution that provides all you need to create, operate, and maintain an online store. Sell unlimited products, one or one million, it's up to you!

If you can fill out a form, you can create a powerful online shopping cart system on your website without the need to hire an expensive programmer or webmaster to help you maintain it.

No additional charges - No hidden monthly fees - You pay one price, and that's it.

All texts in the shopping cart is defined in the file config.php, which makes it very easy to translate our software into any language.

This evaluation version does not submit any items ordered, and the shopping cart have some limitations.

If you like our software, please purchase a full working copy for only USD 79.00.

Product Home Page http://www.midicart.com

Product Order Page http://www.midicart.com/purchase.php

Supported operating systems:
Microsoft Windows NT/2000/XP/2003/2008/Win7, Linux, UNIX
Supported HTTP server software:
Microsoft IIS, PWS, or Apache with PHP4 or PHP5
Supported Database software:
MySQL

Included directories
shop - The webshop directory
alternative_display_of_items_list - Alternative display of goods lists, table or in columns

Included files
readme.html - Setup manual
table_maker.sql - SQL script to manually create the tables. Copy and paste in phpMyAdmin
License Agreement.txt - License Agreement

Installation procedure

1 Contact your ISP for a MySQL server account if you do not already have this feature

2 Modify the file config.php in the shop directory with a text editor such as WordPad or NotePad
$host = "mysql.domain.com";   //mysql database host
$user = "u342167";   //mysql database username
$pass = "Ghy6Rgbv";   //mysql database password
$database = "comshop";   //mysql database
$receipt = "order@domain.com";   //e-mail account for receiving orders
$company_name = "MidiCart Software";   //Company name in order email subject and the title of your online shop
$freight_invoice = "0";   //firm freight charge in format 5.00. If not used = 0.00
$freight_credit_card = "0";   //firm freight charge in format 5.00. If not used = 0.00
$add_tax = "0";   //tax in %. Enter 16.00 for 16%. If not used = 0
$txt_currency="USD";   //currency
Almost all text object can be renamed to your desired language in the file config.php

3 Modify the file login.php in the shop/admin directory with a text editor such as WordPad or NotePad
Enter a suitable username and password
$admin_login = "admin"; // Admin ursername
$admin_pass = "password"; // Password

4 Modify the html code in the bottom of order_invoice_final.php
This is the page that the customer recieves after submitting his order

5 Upload the main directory "shop" to your website.

6 Set the following permissions: (Only Linux/UNIX)
The images directory needs to be chmoded to 0777 (write enabled for all users).

7 Point your browser to the new folder in your website (http://www.domain.com/shop/)

8 Click on the buttom "Create tables in MySQL" in the main frame to install MidiCart PHP tables in MySQL

Go to the administration interface http://www.domain.com/shop/admin/ and add some new items in your database. Try out your new webshop http://www.domain.com/shop/ and send some test orders

Modify the layout and graphics in the shop, then upload these files to your website. If you alter the frameset, you must edit the javascript in middle_left.php and basket.php
Don't try to change the layout if you not are familiar with javascript and HTML

Important
Delete the files setup.php from your website when the webshop is fully functional

Shipping and Tax
MidiCart PHP supports the shipping cost calculated on the total weight of the goods, and a flat shipping rate.
The fixed shipping cost is entered in these variables in the file config.php

$freight_invoice = "0"; //firm freight charge in format 5.00. If not used = 0.00
$freight_credit_card = "0"; //firm freight charge in format 5.00. If not used = 0.00

The weight-based shipping charges are calculated on the order form order_credit_card.php and order_invoice_final.php
The calculation is done by javascript, and may be modified according to your own tariffs

Look for this piece in the files order_credit_card.php and order_invoice_final.php:

// Calculate shipping cost

if(subweight<0.01) {
shipping=<?php echo $freight_invoice ?>;
}
if(subweight>0.01) {
shipping=2.40+<?php echo $freight_invoice ?>;
}
if(subweight>0.02) {
shipping=3.90+<?php echo $freight_invoice ?>;
}
if(subweight>0.10) {
shipping=5.40+<?php echo $freight_invoice ?>;
}
if(subweight>0.25) {
shipping=7.90+<?php echo $freight_invoice ?>;
}
if(subweight>0.50) {
shipping=9.30+<?php echo $freight_invoice ?>;
}
if(subweight>1.00) {
shipping=11.35+<?php echo $freight_invoice ?>;
}
if(subweight>2.00) {
shipping=11.50+<?php echo $freight_invoice ?>;
}
if(subweight>3) {
shipping=11.90+<?php echo $freight_invoice ?>;
}
if(subweight>5) {
shipping=12.35+<?php echo $freight_invoice ?>;
}
if(subweight>10) {
shipping=15.25+<?php echo $freight_invoice ?>;
}
if(subweight>15) {
shipping=19.55+<?php echo $freight_invoice ?>;
}

Explanation

if(subweight>3) {
shipping=11.90+<?php echo $freight_invoice ?>;
}

Meaning that if the weight is more than 3 lb/kg but less than 5 lb/kg estimated shipping 11.90 plus the fixed fee in config.php

The tax is in percentage, you can set this variable in config.php. If you arn't planning to use the tax function, set the value to 0

Checkout function invoice or money orders

1 The customer enters his personal information and clicks the Submit button.

2 The order is being sent by email to the receipt account and a copy to the customers email account

3 The HTML code in the bottom of order_final.php appears

Checkout function credit card payment

1 The customer enters his personal information and clicks the Submit button

2 The customer gets redirected to order_transfer.php, and the order is sent by email to the receipt account and a copy to the customers email account. When the customer clicks on the button "Proceed", a new window which is a redirection to Paypal.

3 The customer enters his credit card information, and completes his order.

Credit card payment through Paypal
Modify the file order_transfer.php in the shop directory with a text editor such as WordPad or NotePad
Look for this piece at the end of file:

<FORM ACTION="https://www.paypal.com/cgi-bin/webscr" TARGET="_top" METHOD="POST">

Enter the e-mail address that you connected to your Paypal account

Solving Common Problems
Problem with shopping cart
Have you edit the framed layout?
Is the frame with middle_left.php named cart?
Have you enabled javascript in your browser settings?
Do you use art no. or item name with special character like ,-/ or .?
The database connection don't work
Check your settings for server IP, username and password in config.php?
Have your server support for MySQL in the http server?
Create a file test.php with this text only, and run it on your server: <? PHPinfo() ?>

Limitations
The field Code No. and Item can only have character and numbers 0-9, a-z and A-Z.
Do not use special characters like , . - _ + ' * in these field.
Exception - Special characters / - _ , & ( ) : ; * # ! works fine in the item name, but some combinations maybe result in an error.
Try to remove all special characters if you have problem to add items to the shopping cart.

THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MIDICART SOFTWARE TAKES NO RESPONSIBILITY FOR ANY DAMAGES SUFFERED AS A RESULT OF USING, MODIFYING THIS SOFTWARE. IN NO EVENT WILL MIDICART SOFTWARE BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF OR INABILITY TO USE SOFTWARE, EVEN IF MIDICART SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.