Setup instruction
MidiCart ASP Shopping Cart

MidiCart ASP 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
Supported HTTP server software:
Microsoft Personal Webserver
Microsoft Internet Information Server
Supported SMTP components:
CDONTS, CDOSYS, Aspemail, Aspmail, JMail
Database drivers:
Microsoft Access (.mdb)
Supported Database software:
Microsoft Access
Sun Star Office 5.2

Notes:
Modifications will be necessary if you plan to use these scripts on other plattforms. MidiCart ASP have a DSN-less ODBC connection, and use Server.MapPath to connect the database midicart.mdb. The file midicart.mdb is a Access 2000 database, and don't work in Access 97. Rename midicart_97.mdb to midicart.mdb if you have Access 97.

Included directories
shop - The store directory (default SMTP component = CDONTS)
order_files - Order files for CDONTS, CDOSYS, Aspemail, Aspmail, JMail
card_payment_files - Examples files credit card payment providers CDONTS, CDOSYS, Aspemail, Aspmail, JMail
images - Images setup manual

Included files
readme.html - Setup manual
date_format.txt - How to change date format in middle_left.asp
License Agreement.txt - License Agreement

How to setup
1 Modify the file settings.asp in the shop directory with text editor such as WordPad or NotePad.
receipt ="order@domain.com"    ' #The 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
add_tax="0"    ' # Tax in %. Enter 16.00 for 16%. If not used = 0
add_freight="10.00"    ' # Firm freight charge in format 5.00. If not used = 0

Almost all text in the shop can be translatet to other languages i the file settings.asp.
2 Modify the layout and graphics in the shop. If you edit the frames, you must edit the javascript in middle_left.asp and basket.asp. The frame with the shopping cart script must be named cart.
Don't try to change the layout if you not are familiar with javascript and HTML.
3 Rename the database midicart.mdb to prevent downloading, and enter the new filename in settings.asp. Don't remove the file extension .mdb.
Example: Change the filename midicart.mdb to Jnbhy7Q.mdb
4 Open the Access database, and add some items. The field Code No and Item in the database can only have character and numbers 0-9 a-z and A-Z.
5 Upload the folder shop to your website.
Point your browser to the new folder in your website. (http://www.domain.com/shop/)

Online database editor
You can edit the database online with your browser, if you install a table editor like UTE 3.01.
Homepage and download: http://www.codeproject.com/asp/ute.asp

Shipping and Tax
MidiCart ASP 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 settings.asp. If you don't use the tax function, you may set the value to 0.

Browse and add item to cart
MidiCart ASP use javascript and ASP, 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 tool could your customer find a specific product. He may chose a field for his searchstring, and get the result in the main window. The search engine fetch all items who has the searchstring in the specific field. The string look like %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.

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 file respons.asp shows up.

Checkout function Credit Card Payment
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 next page order_transfer.asp, is a gateway to your secure payment provider. I this page you have to edit the fields to fit your provider

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.asp 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.asp to fit.

Solving Common Problems
If the shopping cart don't work
Have you edit the framed layout?
Is the frame with middle_left.asp named cart?
Have you enabled javascript in your browser settings?
Do you use Code No or Item name with special character like , or .?
Have your http server an database driver for Access?
If you don't get any order email
The files order_final.asp and order_transfer.asp uses default CDONTS to the order email, but many hosting companies have other SMTP modules in there servers. Ask your ISP which SMTP modul they have installed in your server.
Exchange your order files (order_final.asp and order_transfer.asp) for those which fit your server the best from the folder order_files and card_payment_files. Don't forget to enter a valid SMTP server in the file settings.asp if you don't use CDONTS.


Limitations
The field Code No and Item in the database can only have character and numbers 0-9, a-z and A-Z.
Do not use special characters like , . - _ + ' * in code no and item name.

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