Electronic Delivery Setup

• If ALL ITEMS are delivered through download, go to Free Shipping & No Shipping Setup and follow the instructions. Pay particular attention to the "Shipping Company/Method" section. Then return to this page and follow the instructions under the section "Global eDelivery Settings"
• If you have some items that are physically shipped, and some other items that are delivered electronically, please be sure to complete either the Paid Shipping or Free Shipping sections. Then return here and continue.

OK, if you are reading this, we assume that you have one of the scenarios listed below. Follow the instructions that describes your scenario.

• Scenario 1 - You are selling electronically delivered items and/or services, along with physically shipped items. You are either charging to ship ALL of your physical items, or you are shipping ALL of your physical items for free.
  1. Open Application.cfm.
  2. Look for the variable "attributes.edelivery" and set the value to "Weight".
  3. Make certain that any item that is being shipped has a positive weight set on it in Product Administration.

  Summary of Scenario 1:

  • If there are any items with a positive weight in the shopper's basket, we will collect shipping information.
  • If there are no items with a positive weight in the shopper's basket, we will not collect shipping information.
  • There will be a charge for shipping only on those items with a positive weight.

• Scenario 2 - Identical to scenario 1 except, you will be shipping some of your physical items for free and charging to ship others.
  1. Open Application.cfm and scroll to the "shipping/eDelivery" section.
  2. Look for the variable "attributes.edelivery" and set the value to "Both",
  3. Make certain that any item that you will charge for shipping has a positive weight set on it in Product Administration and that any item shipped for free or that is delivered electronically has a weight of "0".

  Summary of Scenario 2:

  • If there are any items with a positive weight in the shopper's basket, we will collect shipping information.
  • If there are no items with a positive weight in the shopper's basket, we will query the database to see if the items have a file extension or extensions associated with them. If ALL ITEMS have a file extension, we will not collect shipping information.
  • If ANY ITEM DOES NOT have a file extension, we will assume that item is being shipped and collect shipping information.
  • There will be a charge for shipping only on those items with a positive weight.

• Scenario 3 - You are selling electronically delivered items along with physically shipped items. You are also selling services, memberships, or other items that are not shipped or delivered in any manner. Whether you are charging to ship any or all of your physical items does not matter.
  1. Open Application.cfm.
  2. Look for the variable "attributes.edelivery" and set the value to "Both".
  3. Look for the variable "attributes.servicecategory". You don't have to do this next step now, but it is important that you make a note to do it later. Set "attributes.servicecategory" to a Category ID (NOT "Main" Category ID) or comma delimited list of Category IDs that will be for your services or other goods that are not shipped or delivered in any manner.
  4. Make certain that any item that you will charge for shipping has a positive weight set on it in Product Administration and that any item shipped for free, that is delivered electronically, or that is a service has a weight of "0".
  5. DO NOT duplicate any items that are in the "attributes.servicecategory" list under a category that is not.

  Summary of Scenario 3:

  • If there are any items with a positive weight in the shopper's basket, we will collect shipping information.
  • If there are no items with a positive weight in the shopper's basket, we will query the database to see if the items have a file extension or extensions associated with them. If ALL ITEMS DO have a file extension, we will not collect shipping information.
  • If ANY ITEMS DO NOT have a file extension, we will then check to see if any of those items are in a category that IS NOT in the list of service categories we set in the "attributes.servicecategory" variable. If we find any "0 weight" products not in that list, we will collect shipping information for the order.
  • There will be a charge for shipping only on those items with a positive weight.

Global eDelivery Settings

• Open Application.cfm and scroll to the "shipping/eDelivery" section.
• Look for the line...
  
  <cfset attributes.order_status_path = "example.cfm?page=order_status.cfm">
  
  This is the default variable for our example page which we will cover more later. If you are going to be using the standalone application, make this variable "ezcart/order_status.cfm". If you are going to be using the integrated version, just leave this as it is. Once we go through the setup in the example.cfm sample page, you will be changing the example.cfm part to the name of your own template. We'll remind you at that time which variables you need to change.
• Look for the line...
  
  <cfset attributes.edeliveryfilepath = "">
  
  Set this variable to the SERVER PATH of the directory where your downlaodable items will be. This path CAN and SHOULD be outside of your web root, or in the very least, in a password protected directory. Use a trailing backslash at the end of your path. For Windows this will be something like...
  
  "C:\inetpub\wwwroot\yoursite\downloads\"
  
  or for Linux and Sun
  
  "/home/www/yoursite/downloads/"
• Look for the line...
  
  <cfset attributes.edeliverydays = "7">
  
  Enter the number of days you want the file to be available for download after the order is placed. Keep in mind that if you accept checks, this needs to be long enough for you to receive the check, and if you desire, wait for the check to clear.
• You should test your setup by placing an order for an existing file. The order must be approved before you may download the file.
• If you have problems with the downloads, open the file ezcart/order_status.cfm. Look near the top for the line...
  
  <cfset variables.usealternate = "0">
  
  Change the "0" to "1". Again, this is if you have problems with the download.
• We will attempt to give feedback on an error. If you get an error that This Document Contains No data or Page Not Found, first try the setting above. If you do find the page, but get a message on the page that the file can't be found, we will show you the path to the file (if you're in test mode under Purchasing Setup) so that you may see if you have your settings correct. If you simply can't get this working, contact buddy@twcreations.com.