This is version 1.1 of the MCart 4.0 User’s Guide. All updates to this document will be noted below.
This document is the user manual for the free shopping cart called MCart 4.0 and the paid for version, MCart Pro 4.0, offered by AIT.
Table of Contents 2
Introduction 4
Accessing your cpanel/SMT 4
Installation 5
Setting Up Shop 6
2.1 HTML Setup 9
2.1.1 Simple Setup 10
2.1.2 Custom Setup 11
2.1.2.1 Creating header and footer files 12
Follow the areas below to create the required header and footer files. 12
2.1.2.2 Custom Setup MCart Admin 15
2.1.3 Additional Options 17
2.1.3.1 Maximum Items per Page 17
2.1.3.2 Display Category Menu In Headers 18
My Shopping Cart 18
2.1.3.3 Target for Secure Pages 18
2.1.3.4 Alternate Checkout URL 19
2.1.3.5 Cookie Timeout 19
2.2 Order Info Setup 19
2.2.1 Order Dept Name 20
2.2.2 Phone Number 20
2.2.3 Fax Number 20
2.2.4 Email Address 20
2.2.5 Ecommerce User ID 21
2.2.6 Referrer Question 21
2.2.7 E-mail for Informational Messages 22
2.2.8 Commission Tracking Programs 22
2.3 Configuration Setup 22
2.3.1 Separate shop into categories 23
2.3.2 Disable search engine 23
2.3.3 Select allowed fields 24
2.3.4 Optional Field Labels 24
2.3.5 Inventory control 25
2.3.6 Display Stock Information 26
2.3.7 Default ETA Message 27
2.3.8 Default Currency 29
2.3.9 Sales Tax 30
2.3.10 Basic Shipping Model 30
2.3.11 Additional Shipping options 31
2.3.11 Order Tracking 33
2.4 Inventory Setup 33
2.4.1 Category Functions 34
2.4.2 Change listing order 35
2.4.3 Import/Export Menu 36
2.4.4 Setting up your inventory item-by-item 42
2.4.4.2 Update list 45
2.4.4.3 Edit Item 46
2.4.4.4 Copy Item 46
2.4.4.5 Remove Item 46
2.5 Change Admin Password 46
2.6 Purge Cart Database 46
2.7 Review Orders 47
2.7.1 Tracking Info Setup 47
2.8 PGP Key 48
2.8.1 Generate public and secret key 49
2.8.2 Extract your public key 49
2.8.3 Insert Key 49
3. Common Errors 50
3.1 PGP Order Processing 50
3.1 Custom Setup Errors 50
3.3 Full Ecommerce Order Processing 50
4. Module Key Activation 51
5. Discounts 51
6. Additional Help 55
Resources: 55
Paul J. Crispi at PrimoCaps.com 55
Sean McCoy and Allen Horman at Netrphia.com 55
Steve Barbee at btigroup.com 55
Marshall Mermell at c911.com 55
Introduction
MCart
is a shopping cart, catalog and indexing web store all rolled into one. Version 4.0 is provided free of charge to all AIT customers, and there is an upgraded version (MCart Pro 4.0) that is a paid for upgrade. The addition shopping cart modules that can be
activated are a part of MCart Pro 4.0.
MCart Pro contains many different modules that will allow you to shape MCart to your own personal needs:
-
Order Tracking Module – Allows your shoppers to track their orders through UPS or FedEx
-
Discount Module – Allows you to offer special sales for certain periods of time. This module also allows wholesale sales.
-
Miva® Module – Allows you to import data from a Miva® shopping cart.
Accessing your cpanel/SMT
To first install MCart, you must gain access to the control panel or SMT. The screen below can be seen when users open a web browser and go to
http://theirdomain/cpanel/ or
http://their.IP.address/cpanel/
The login for the SMT 4.1 is always ‘cpanel’
without the quotes, and the password is always the main server password. If this has not been changed by the user, then it is the same password that AIT provided the user after the setup of the account.
Once logged in, the user will see the cpanel/SMT Introduction screen, which should look something like what is displayed below in Figure 1-1.
Figure 1-1
To install MCart or to upgrade to the current version, select the Install Shopping Cart inside of the Web Services menu on the left in the SMT/cpanel.
-
NOTE: If you are upgrading to the Mcart 4.0 from an earlier version, ALL character strings that are in place of an expected numerical value in your inventory (ex. “$2000 each” in the Sales Price field, etc…) or numbers in these fields that contain commas (ex. “2,000” in the Price field, etc…) will automatically be installed in the appropriate Mcart 4.0 field only as the numerical value shown (ex. “2000.0”).
The installation interface is shown in Figure 1-2.
Figure 1 2
-
MCart Version – By default, the ‘PGP Version’ option is selected. This does not require that the shop is tied to a merchant account or gateway, but does require that the shop use PGP encryption and decryption for orders.
-
Shop Directory – This is the directory under which the MCart files will be put into. This is very closely tied to the next option of ‘Virtual Host’. For example, if you wish to add an MCart for a top level domain, simply input the word ‘mcart’ into the Shop Directory section and the shop will install in the /www/htdocs/mcart directory. If you wish to install MCart for a virtual host directory, then inputting the word ‘mcart’ into this field and selecting the virtual host domain name from the ‘Virtual Host’ section will put the MCart into the directory /www/htdocs/virtualhost/mcart. Thus, the installer is smart and puts the MCart in the directory structure that makes sense for you.
-
User Name – This is the username that will be used as the administrator for the Administrative section of MCart. The default is shopkeeper. You can change the username as long as it is at least 6 characters. This username can only be changed by reinstalling your shopping cart. Reinstalling your shopping cart will not delete data in your shopping cart; the newer version simply overwrites the older version and copies all the data in the process.
-
Password - The password must be at least 6 characters. If the shop administrator forgets their password, you can re-install MCart to reset the password.