What is this module?

ClickBank Downloads validates purchases on payment
processor ClickBank, and provides a "secure" file download link. See the project page for a full write up.

Currently, this project is in the process of review for full project status, therefore you'll need to git clone it in order to use it.

Getting Started

These instructions assume you have already created and uploaded your product information to a ClickBank Account.

  1. Download the module and install on your Drupal site as usual.
  2. Enable the module
  3. Navigate to admin/config/media/clickbank
  4. Enter your secret key from your ClickBank account
  5. Upload your product images (admin/structure/taxonomy/clickbank_download_images/add)
  6. Upload the digital goods (admin/structure/taxonomy/clickbank_download_files/add)
  7. Create product nodes combining ClickBank product ids and the previously uploaded images and files (node/add/clickbank-download-product)
  8. Set the "ClickBank Download Block" in the region it should appear (admin/structure/block)
  9. Test that downloads work successfully (see below!).
  10. Uncheck the "Debug Mode" option on admin/config/media/clickbank
  11. Change the Thank You page in ClickBank to a URL where the "ClickBank Download Block" will appear for each product

Testing Products

Before changing all the "Thank You" pages in ClickBank, I recommend that you create one dummy product inside ClickBank that customers will not be able to see. Next, create a test credit card inside ClickBank. Then create a new product node inside Drupal with that product ID. Logout out of Drupal and try to complete a purchase of your dummy product using the test credit card. If all works, you should see the product image and all download links for that product. Do click the download link(s) to ensure (1) downloading works, and (2) the correct file is downloaded.

No ClickBank Account

If you do not have access to a Clickbank account, go to the module configuration page and check the "Debug Mode" checkbox. Then go to the url with your download block enabled, and add a query string like this:

?item=<product_id>

For example, to test a product with an id of 1 at example.com/downloads, point your browser to:

http://example.com/downloads?item=1

You should see the title, product image, and the download links. Clicking the download links should trigger an immediate download.

NOTE: Using this setting turns off purchase validation, (allowing anyone to download files without purchasing them). So remember to uncheck that box before trying to sell anything.

Future versions of this module will make testing easier by providing test links to the download goods.

If Downloads Work...

Set the products' "Thank You" pages to point to the node with the ClickBank block enabled. Make sure the images and digital goods match what you described in your "Pitch Pages." You should be all set!

If Something Goes Wrong...

  • Make sure that your secret code in configuration page (admin/config/media/clickbank) matches the value set inside ClickBank.
  • Make sure that the product id numbers match the numbers inside ClickBank
  • Make sure that the "Thank You" page listed in ClickBank is correct.
  • Check that all roles can access the ClickBank block inside the configuration page
  • When in doubt....clear the Drupal cache?

If these steps do not fix your option, search the issue queue for a similar problem to your own. Feel free to ask for help AFTER checking the issue queue.

Optional Steps

Set Error Messages

If users are unable to download the product, you can customize the error message inside the module configuration page (admin/config/media/clickbank), although a default message is provided.

Set a file download prefix

The file prefix setting on the module configuration page (admin/config/media/clickbank) will add some text to the front of a file downloaded by your customers. This can be helpful if you want to help customers find your files later, but you don't want to rename files before uploading them. NOTE: Do not put any spaces in the prefix.

Change the Cookie Settings [Advanced]

On the config page (admin/config/media/clickbank), you can change both the name of the cookie that grants customers permission to download files, and how long that cookie stays on their computer. Changing these settings could prevent anyone from downloading the files, so if in doubt leave it alone.

Increase File Security [Advanced]

If you have access to the server that your Drupal site lives on, setup a "Private file system path" at admin/config/media/file-system. The folder should be above the web root directory so that it inaccessible through any URL on your site. Once you've set the "Private file system path", go to admin/structure/taxonomy/clickbank_download_files/fields/field_clickbank_download_files/field-settings and change the "Upload destination" to Private files.

Even if you do not do this step, your content will not be exposed to a visitor at any point during a purchase. File download links point to the module code, and not directly to the files. Although, it's probably unnecessary, the value of this step is to prevent Google and other search engines from ANY possibility of indexing your digital goods.

Theming

Copy the clickbank-download-block.tpl.php from the module directory into your theme directory to customize the code. There isn't a lot of flexibility on how various custom fields are displayed within the ClickBank Download box, but you can probably do most cosmetic changes using the template file and CSS that you need.

If you'd like to see more granular control, submit a feature request on the project page.