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 demo 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 - Payment provider Kagi    https://order.kagi.com
Product orderpage - Payment provider RegSoft    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 or PWS, and Apache with PHP3 or 4
Supported Database software:
MySQL

Included folders
shop_php_old - Shop files for PHP 4.1.x and older, or servers with register_globals = On
shop_php_new - Shop files for PHP 4.2.x and newer, or servers with register_globals = Off
linux-unix_files - Examples files to some secure payment providers (Linux/UNIX users)
windows_files - Examples files to some secure payment providers (Windows users)
items_list_with_image - A prod_list.php file. Display items list with images
images - Images setup manual

Create a file test.php with this text only, and run it at your server to find out your PHP version.

<? PHPinfo() ?>

Included files
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

Advanced database management tool
phpMyAdmin - Download page
Perfect for import, export and backup

Windows users
If you plan to use these scripts at a Windows server, you must replace 2 files and add 2 new file.
Replace the order_final.php and order_transfer.php with the files order_final.asp, order_transfer.asp and response.asp from the windows_files folder.
Copy the file settings.asp the your shop folder.
Open the setting.asp and enter your e-mail account and set the txt_currency.
Change form action in order_money.php and order_card.php to order_final.asp and order_transfer.asp.
Windows users can't store CC information in MySQL

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.

How to setup
MidiCart PHP use javascript and PHP, and are designed for use Linux/UNIX and Apache. 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 he push the secondgroup link, all products is listed in the main window.
1 Contact your ISP for an account in a MySQL server.
2 Modify the file config.php in the folder shop_php_old or shop_php_new
Edit the database host.
Edit the database username.
Edit the database password.
Edit the database name.
Edit the e-mail account for receiving orders.
Edit the currency
Edit the upload path.
Enter shipping and tax.
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_php_old or shop_php_new to your web server.
5 Set the following permissions: (Only Linux/UNIX)
chmod 755 and the 777 for the images directory.
6 Point your browser to http://www.domain.com/your_shop_files/setup.php to create the tables in MySQL.
Remove the file setup.php from your website when you have created the tables.

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

Modify the layout an graphics in shop, and 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 in javascript and HTML.

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 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

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.

You find a nice passwordgenerator at http://www.inch.com/info/tech/HOWTOS/htaccess/htpasswd.html

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

Browse and add item to cart
MidiCart PHP use javascript and PHP-script, and are designed for use in WinNT/2000 with IIS. All pages built "on the fly" from the Access 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.


Limitations
The shopping cart has a limit of 30 items. You can increase the number of items in order_final.php and order_transfer.php.
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.

2003 © Copyright MidiCart Software. All rights reserved