Downloadable Products

SmithCart > Products

The cart fully supports selling software, music files, clip art, eBooks and any other type of downloadable file. The download urls are completely secure and hidden from the user to prevent piracy.

Contents


Introduction

To access the Downloadable Product setup, either Add a New Product or Edit an existing Product. For detailed instructions for Adding or Editing a Product, see the Manage Products KB article.

SmithCart fully supports secure urls for your downloadable products that hide/mask the url from the user. The cart will prevent the user from locating the download url using the following methods:

  • Cart uses server side code for generating download url so the product url is fully hidden from the user.
  • Prevents download url from showing up in the browser status bar when user hovers their mouse over download button.
  • Prevents user from getting the download url by right clicking on the download button and clicking properties.
  • Product download url is not visible in browser source.

The Download Now link will be displayed on the Confirmation Status page after successful purchase next to the product in the order details. The Download Now link is also available to the user in the My Accounts module for downloading after purchase.

The following is a screenshot of the product details section of the confirmation page showing the download button:

[up to contents]



Downloadable Product Setup

To enable a downloadable product to be presented to the user the Downloadable Product section of the Product Setup screen is required to be configured. The Product Level Options section below describes the Downloadable Product section of the Product Setup screen.

Configuration settings can also be found on the following 2 management screens:

  1. Store Settings
  2. My Account Module Settings

[up to contents]



Product Level Options

The following Product Level Options are available to be configured at the Product level on the Product Setup management screen:

Download URL – Enter the URL to the product.

Before entering the path in the Download URL field do the following:

Note: By allowing you to copy your downloadable products to your server using FTP you can copy as many products as you wish in a single operation rather than uploading your products one by one. This should save you quite a bit of time!

  1. Choose a folder on your server where your downloadable products will reside.
  2. The location for your downloadable products can be off the portal root of your DNN site or the files can be located on another server.
  3. Next, copy your electronic product files to the directory you just created on your server. Uploading your files can be done using the DNN file manager, FTP or remote desktop to your server.
  4. Enter the URL for your downloadable product in the Download URL field

URL syntax for downloadable products:

http://domain-name/portals/portal#/subdir/downloadablefile

Example URL: http://www.mydomain.com/portals/5/myproducts/myproduct.zip

Auto Generate GUID – The auto generate guid provides additional security features for preventing piracy of your downloadable products. When this checkbox is checked the cart will automatically generate a unique GUID and add the GUID to the end of the download url.

Auto Generate GUID Example:

Download URL: http://www.mydomain.com/somefolder/somepage.aspx?guidid=

When auto generate GUID is checked the download URL generated by the cart will be the following:

http://www.mydomain.com /somepage/somefolder.aspx?guidid=23DQ42WT8R4

Notice in the example above the question mark and the variable name in the querystring are added by the admin which gives you the flexibility to add additional querystring parameters and name the variables anything you want.

In the example above, the aspx page named “somepage.aspx” is used as a gatekeeper program that control passes to when the user clicks the download button after successful purchase. The Gatekeeper Download Manager is a companion program developed to work with SmithCart and provides additional levels of security for your electronic products.

Features include:

  • Anti-piracy features for electronic products
  • Velocity Checks - number of times and/or number of days to allow file to be downloaded by a recipient
  • PDF Watermarking/Stamping - Stamp every page with pre-defined fields from the order. Stamps are secure and cannot be removed.

For more information about the Gatekeeper module, please see the GateKeeper Manual at the following link: GateKeeper Module.

[up to contents]



Securing Downloadable Products

Using the DNN file manager create a "Secure File System" folder to store your electronic products. The files within this directory will have .resources appended to the filename. The secure file system prevents hackers from downloading your soft goods directly using a browser as IIS and Asp.Net will not allow .resources files from being downloaded.

In order to generate the download link for your soft goods that you have secured using the secure file system you need to utilize the DNN LinkClick.aspx file processor to serve the file up which makes it possible for you to set the file view permissions to restrict the viewing to just authenticated users or any other selected role. Once you generate the DNN linkclick url just cut and paste the url to the download url field in the SmithCart product setup screen and your electronic products will be fully protected.

Step by Step Instructions:

  1. From the dnn admin menu - file manager navigate to your portal root and enter a folder name in the "Folders" field
  2. Select the option "Secure - File System" from the folders dropdown list and click the "Add folder" button
  3. Using dnn file manager upload or copy your downloadable product files to your new secure folder you just created
  4. Go to any dnn page and from an html module click the hyperlink icon from the rich text editor and create a file system link to the file in your secure folder.
  5. DNN will create a secure linkclick url
  6. Copy and paste the link click url to your clipboard or notepad
  7. Go to the SmithCart product setup screen for your downloadable product that you want to secure
  8. Paste the linkclick generated in step 6 in front of the full url to your portal root. It should look something like this:

    http://www.yourdomain.com/Portals/[yourPortalRoot]/Products/LinkClick.aspx?fileticket=0NI7XZREIeB0%3c&tabid=114

[up to contents]



Store Settings Options

The following options are available to be configured at the Store level on the Store Settings management screen:

Email Download Link - When enabled and a customer purchases a downloadable product, the Cart will email the customer a link to the downloadable products in the confirmation email.

For more information about the Store Settings management screen, please see the Store Settings KB article.

[up to contents]



My Account Module Options

The following options are available to be configured for the MyAccount module on the My Account Settings management screen:

Hide Download Link - Check this box to hide the download link in the My Accounts module. The download link is used by the user to download soft goods like software.

For more information about the My Account Settings management screen, please see the My Account Module KB article.

[up to contents]



PDF Merge

SmithCart includes the ability to merge multiple PDF files into a single PDF document and serve up a download link to the user to download the merged PDF document.

To setup a SmithCart product to merge multiple PDF files, you must setup both the “Source” PDF documents and also configure the “Destination” file name for the merged PDF document that is outputted by SmithCart.

PDF Source Files

The PDF source files you want to merge are contained in the Smith_ProductDownloads table. The structure of the Smith_ProductDownloads table is as follows:

  • ProductID - SmithCart ProductID
  • DocumentID - This is for integration with 3rd party document module for reference purposes.
  • SourcePath - This is the full url to each document.
  • SortSeqNo - This field is an integer that will be used to define the order of the documents in the merged PDF.

Please see the following example Smith_ProductDownloads table with data populated:

Please Note: You should only populate the “Smith_ProductDownloads” table if you have a single SmithCart product that has multiple PDF’s you need to merge into a single PDF document.

PDF Destination File

The destination PDF file is the file that SmithCart outputs to your server that contains the contents of multiple merged PDF documents. To set up a product to merge multiple PDF files, you must setup the following fields in the Downloadable Product section of the Product Setup page.

Download URL – The full url path and file name to the merged PDF file for the product.

For Example:http://www.mysite.com/portals/0/smithcart/customerdownloads/mydoc.pdf

In the example above “mydoc.pdf” is the name of the merged PDF after SmithCart merges the PDF files found in the “Smith_ProductDownload” table.

Product Path – In this field, enter the relative path and file name to the merged PDF file for the product. The relative path should start after the “\portals\[portalid]” folder, located directly off the root of your DNN install.

For Example:

/SmithCart/CustomerDownloads/myDoc.pdf

Auto Generate GUID – The auto generate guid provides additional security features for preventing piracy of your downloadable products. When this checkbox is checked the cart will automatically generate a unique GUID and add the GUID to the end of the download url.

Checkout and PDF Merge Process

After a user successfully completes the checkout process, SmithCart will do the following:

  • For each product on the order, SmithCart will look up the product id in the Smith_ProductDownload table ordered by the “SortSeqNo” field.

  • SmthCart merges all the source PDF files in the “Smith_ProductDownload” table by product id into one PDF document using the path provided in the “DownloadURL” and “ProductPath” fields configured in the SmithCart product setup screen described in the PDF Destination File section above.

  • The merged PDF document is then saved in the destination folder provided in the “ProductPath” field configured in the SmithCart product setup screen.

  • Finally, a download link is displayed to the user in the order detail grid of the confirm status page of the SmithCart checkout. When the user clicks on the download link the merged PDF document will be opened in a new window for the user to view or save.