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.

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 just USD 79.00.

Product homepage    http://www.midicart.com
Product orderpage    http://www.midicart.com/purchase.html

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

Included directories
shop - The store directory
card_payment_files - Examples files to some credit card payment providers
images - Images to the setup manual

Included files
quick_setup.html - Quick setup manual
readme.html - Setup manual
setup.php - A setup file who create the tables for MidiCart PHP
table_maker.sql - SQL script to create the tables. Copy and paste in phpMyAdmin
License Agreement.txt - License Agreement

Installation procedure
1 Contact your ISP for an account in a MySQL server.
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
$txt_currency="USD";   //currency.
$upload_path = "/home/u342167/html/shop/images/";   // upload path
$add_tax = "0";   //tax in %. Enter 16.00 for 16%. If not used = 0
$add_freight = "0";   //firm freight charge in format 5.00. If not used = 0

Allmost all text strings in the shop can translated to other languages in the file config.php.
3 Modify the html code in the bottom of order_final.php.
This is the page who the customer get when he submit his order.
4 Upload all files in the folder shop to your web server.
5 Set the following permissions: (Only Linux/UNIX)
The images directory needs to be chmoded to 0777. (write enabled for all users).
6 Point your browser to the new folder in your website. (http://www.domain.com/shop/)
7 Click on >>> Click here to install MidiCart PHP 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 items in to the database. Try out your new shop 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 edit the frames, you must edit the javascript in middle_left.php and basket.php. The frame with the shopping cart script (middle_left.php) must be named cart. Don't try to change the layout if you not are familiar with javascript and HTML.

How to find out the upload path
Point your browser to http://www.domain.com/shop/
Click on >>> Display show_settings.php <<< in the main frame
"The true path to the images folder" is your upload path


Important
Remove the file setup.php and show_settings.php from your website when the store is working.

Administration Interface
In this area the shop administrator edit the database, and view the credit card information. The interface is similar with the shop, but instead for buying products you may add, delete or update products. The link Credit Card Payment points to the list of credit card information. Use a SSL secured connection when you read this file.

Shipping and Tax
MidiCart PHP have support for shipping cost in a fixed charge, and an item shipping price. The tax is in Percent, and those variables you set in the config.php. If you don't use the tax function, you may set the value to 0.

Checkout function Invoice or money orders
1 The customer enter his personal information and push Checkout.
2 The personal information and the order sends 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 shows up.

Checkout function Credit Card Payment
1 The customer enter his personal information and push ?Continue?
2 In next page order_transfer.php, the personal information and the order sends by email to the receipt account and a copy to the customers email account. This page is also a transfer to the file /secure/order_secure.php in a window there you must have a secure SSL connection.
3 In order_secure.php the customer enter his credit card information, and push Submit.
4 The final page is /secure/order_final.php. This page put the card information in the database under the table card_payment. The order and personal information is sent by e-mail, only the CC numbers is stored in the database. Use a secure SSL connection when you read this data.


USE A SECURE PAYMENT PROVIDER LIKE AUTHORIZE.NET, PAYPAL OR WORLDPAY FOR BETTER SECURITY

How to use a secure payment provider like Authorizenet, PayPal or Worldpay
The file order_transfer.php is a gateway to your secure payment provider. Open the folder files, to find some examples files.
If you plan to use an other external payment provider, you have to edit the fields or fieldname in the bottom of order_transfer.php to fit.

VERY IMPORTANT SECURE THE ADMIN DIRECTORY
Linux/UNIX users
You'll first need to create an .htaccess file in the directory that you want to be protected, it should be chmod 644. This can be done with your favorite text editor. For further information, search on .htaccess how to at Google or an other search engine.

Window users
Please use the standard security system in IIS. Ask your ISP.

Browse and add item to cart
All pages built "on the fly" from the MySQL database. The items is grouped in a main and a secondgroup. When the customer clicks on a maingroup all secondgroups are listed.
When the customer push the secondgroup link, all products is listed in the main window. Both code no and item name links to a page who shows all details and the image. When he push the buttom ?Add?, the item puts in to the shopping basket.
Search Engine
With this facility your customers can find a specific product. They may select a field from the drop down searchstring, the results are presented in the main window. The Search Engine finds all items within the specific field of the searchstring. The "string" script is written as %string%.
Links in result page
When the customer push the secondgroup link, all products is listed in the main window. Both code no and item?s name links to a page who shows all details and the image. When he push the buttom ?Add?, the item puts in to the shopping basket.

Shopping Basket
In the shopping basket the customer can see all his items, and remove or change quantity of a selected item.

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 code 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() ?>
Ask your ISP.
If you get an Notice error when you submit orders
Open the fil php.ini and change the error_reporting variable from error_reporting = E_ALL to error_reporting = E_COMPILE_ERROR|E_ERROR|E_CORE_ERROR


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.

Copyright MidiCart Software. All rights reserved