Uploading Your Shopping Cart

There are several scenarios depending upon how you are set up for using SSL transactions, and whether or not you are going to be using the standalone application, or more likely, integrating the cart into your new or existing website. You may have your own SSL Certificate or may be using a shared certificate supplied by your host. If using your own, then the URL would be something like...

https://www.yoursite.com/

If using a shared certificate, the URL would likely be something like...

https://secure.yourhost.com/yoursite/

When we refer to the "Web Root" below, we mean the main folder/directory of your web site where your Home Page is located, usually index.htm, index.html or index.cfm.
NOTE: If you have a need to completely separate cf_ezcart from your main site, make a new folder for the the shopping cart folders. Then use that folder when we reference the "web root" below.

Note if running ColdFusion MX: Macromedia changed CFMX to load an external javascript file (cfform.js) when using CFFORM. They call this file using a relative path from the root, like so...

<script LANGUAGE="JavaScript" TYPE="text/javascript" SRC="/CFIDE/scripts/cfform.js">

The problem is, on a virtual host scenario, /CFIDE/scripts/cfform.js (note the leading /) will be pointing to a CFIDE folder inside of YOUR web root, which of course isn't there (DUH!). We've included a folder called CFIDE for CFMX. If you are using virtual hosting, rename this folder to CFIDE and upload it to your web root. Then we won't get File Not Found and other perplexing errors when loading CFFORM.

If you are running under shared SSL, with a URL such as http://secure.yourhost.com/yoursite/, the CFIDE will still be missing unless your host places it at the root of secure.yourhost.com. You may wish to ask your host about this issue. In some browsers there are no errors and in others there are. So just because you are not seeing errors does not mean no one else on your site is.

CAUTION! If you are installing cf_ezcart on your own personal server, and installing it in the main web root of the server, where the actual CFIDE folder is installed, be certain NOT to upload this folder, lest you overwrite the actual CFIDE. This is why we named it CFIDE for CFMX, so you don't overwrite the original by accident under this scenario.

NOTE: Do not rename the ezcart or ezcartsecure directories.

1. Upload Application.cfm to your Web Root. NOTE: If you already have an Application.cfm file in your web root, the two Application.cfm files will need to be merged together, or one them included in the other with cfinclude. Or we may have to rename the new Application.cfm and cfinclude it in the templates that the cart will be integrated into. NOTE! For best results, all of your ColdFusion pages should access a single cfapplication tag. If you already have an Application.cfm file in your web root and aren't sure what to do, please don't hesitate to contact us. We will need access to your web server in order to help.
2. If you do not wish to merge the cart into your site, you may make a separate directory, then place Application.cfm in the new directory.
3. Upload the "ezcart", "ezcartsecure", and "store" directories to your web root, or to the new directory create in the step immediately above if you created one. Do not change the name of either the ezcart or ezcartsecure directories. These directories must be accessible through SSL if you are accepting credit cards or using Google Checkout.
4. If integrating your shopping cart into your website, also upload the "store" directory. This directory may be renamed if necessary. The "store" directory is not needed if using the standalone version of the cart.