Configuring the E-goods Addon
page last edited on 02 May 2018
To start using the addon E-goods in an X-Cart 5 store, the store administrator needs to enable (activate) it. General instructions for addon activation can be found in the section Activating and deactivating addons of this manual.
Once the addon has been enabled, the store administrator must adjust the addon settings via its Settings page.
The following settings can be adjusted:
Download link TTL (days): Specify the number of days that a buyer of a downloadable product should be able to access the product they have purchased using the product download link provided to them. To allow unlimited access, set this value to zero. Important: The “Download link TTL (days)” setting does not apply to files on Amazon S3 Signed URLs. If a downloadable product file is stored on Amazon S3, the Amazon Signed URL for it will be available for 7 days; X-Cart has no control of that. The link availability in this case, however, can be restricted using the setting “Downloads limit (per 1 ordered item)”. (See below)
Downloads limit (per 1 ordered item): Secify the number of downloads that should be available to the buyer who has purchased a downloadable product (i.e. how many times the buyer of a downloadable product should be able to download the product using the download link provided to them). To allow unlimited access, set this value to zero. Important: Since it is not possible for X-Cart to track the download of files from Amazon Signed URLs, for files stored on Amazon S3, the setting “Downloads limit (per 1 ordered item)” will only affect the number of times that a URL can be opened by the buyer (regardless of whether the file has been downloaded).
Keep a history of downloads: Specify whether your X-Cart store should keep a history of downloads for downloadable files. Because X-Cart cannot track downloads from the Amazon S3 storage, for files stored on Amazon S3, the history of downloads will be formed based on the buyer’s attempts to open the respective Amazon S3 Signed URLs.
Show only ESD related fulfilment statuses: If you sell only downloadable products and want to get rid of any fulfilment statuses that are used for tangible goods, but not for e-goods, enable this option. It will disable all the standard X-Cart order fulfilment statuses except for the following three: New, Delivered and Will Not Deliver. If you wish you can rename the statuses as you require using the addon Custom order statuses.
Approve before providing access to download: Disable this option if you want the buyer of a downloadable product to automatically get a download link for the product they have purchased as soon as they have paid for the order. Enable this option if you want all e-goods orders to be submitted to you for manual review first so you can approve or forbid access to the downloadable file for the buyer. (In the manual review mode, all e-goods orders will be created with the fulfilment status Waiting for approve; for the buyer to get a download link, you will need to reset the order fulfilment status from Waiting for approve to any other status, except for Will not deliver).
To facilitate the download of large file attachments (100 Mb and larger) by customers, use X-Sendfile. To do so, contact your hosting provider to make sure X-Sendfile is installed on the server and configure your X-Cart installation to support large file downloads. For details, see the section Configuring your X-Cart server for better large file download performance.
Alternatively, use Amazon S3 Signed URLs. See the section Configuring Amazon S3 Signed URLs for more info.
Due to the specifics of how digital products are delivered to the buyer, you should also give some thought to what payment methods you will make available on your store website. You may consider disabling any online payment methods with automatic order processing and choose to enable only those payment methods that require manual processing, or you may choose to enable payment methods that allow using the “auth only” mode. (The “auth only” mode means that the order total is not withdrawn from the buyer’s payment card at the time of order placement, but an authorization is requested to ensure that the required sum is actually available. The store administrator needs to take steps to manually capture the authorized amount or void the authorization. The download link does not become available to the buyer until the order amount is captured and the order gets processed). Processing orders that contain downloadable products using payment methods with “auth only” mode or other methods that require manual order processing allows you to filter suspicious and potentially fraudulent orders and approve only trustworthy purchases.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.