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/

Listed below are several scenarios, from the most desirable to least desirable. When we refer to the "Web Root", 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. Then use this 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.

If integrating your shopping cart into your website:

• Scenario 1, Secure URL points to your Web Root. This method is recommended and is the most widely used.
  1. Upload the "ezcart", "ezcartsecure", and "store" directories to your web root. You can change the name of the "store" directory if you wish. Do not change the name of the other 2 directories.
  2. 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.

• Scenario 2, Secure URL points to A) a folder other than your Web Root, and is on the same server, or B) a folder on a separate server but you can still use a single datasource.
  1. Same as scenario 1, except upload the ezcartsecure folder to the secure folder instead of to the web root.
  2. Create a new folder named ezcart in the secure folder (not the ezcartsecure folder). This folder will be next to the ezcartsecure folder. We will upload just the following folders from the original ezcart folder into the new empty ezcart folder you just made.
     • checkout.cfm file
     • emailverify.cfm file
     • applicationvariables folder and all files within
     • buttons folder and all files within
     • images folder and all files within
     • includes folder and all files within
     • qry folder and all files within
     If your ARE NOT using real-time credit card processing, create a folder within the ezcart folder named admin. Upload the following files and folders from within the original ezcart/admin folder to the new admin folder.
     • action.cfm file
     • login.cfm file
     • orders.cfm file
     • orders folder and all files within
  3. Upload the same Application.cfm as you did to the web root. All settings will be identical EXCEPT possibly the localpath variable. The localpath variable is covered in Initial Application.cfm Settings.

• Scenario 3, Secure URL points to a folder on a separate physical server and cannot access the main database. We highly recommend finding a new host if this is the case, but is unlikely if you're using SQL Server or MySQL, which are usually on a machine separate from the web servers, and can be accessed by all web servers in the network.
  1. Follow the same directions as Scenario 2, except...
     • You must either use the ezcart_vX_orders.mdb Access database, or create a new SQL Server or MySQL database with the same structure.
     • Skip Step 2 and do NOT upload anything from the ezcart folder.
  2. Return to the Create Your Datasource chapter and create a 2nd datasource to access the ezcart_vX_orders.mdb database or your Orders database if you created one.

If using the standalone version of the shopping cart:

• Follow the scenario above that fits your SSL setup except...
  • The store directory is not needed.
  • Place Application.cfm directly into the ezcart folder.
  • Do not upload any files that are not already in the ezcart folder.
  • Rename the if_needed_Application.cfm in the ezcartsecure folder to Application.cfm and leave it in the ezcartsecure folder.