magento:downloadplus:admin

DownloadPlus Pages in the Administrator

DownloadPlus is allowing Downloadable Products to be used in Bundled Products. When wanting to use a Downloadable Product as part of a Bundled Product you need to set Links can be purchased separately to No in the Downloadable Information tab of your Downloadable Product as all downloadable links of a Downloadable Product will be used in the Bundled Product and download is links separately is not possible when using it in a Bundled Product.

The Downloadable Information tab of the Downloadable Product page is extended to show a drop-down selection of previously used titles for the other downloadable links. This to allow easy reuse of already saved titles.

To use the title from the related input box leave the selection at - Use entry above-. Or otherwise select one of the titles of the drop-down selection and save the product, to overwrite the existing title.



DownloadPlus allows to add product attributes to the individual downloadable links. With the related modification of the frontend template, these attributes will then be shown as part of the download link title and description:



Create the Attribute

To create a custom attribute, use the Magento default product attributes in Catalog » Attributes » Manage Attributes:

  1. Use the prefix downloadable_link_ for the Attribute Code to identify it for DownloadPlus as attribute related to the downloadable links.
  2. Apply the attribute to Selected Product Types » Downloadable Product only.
  3. For the Frontend Properties set all to No, except for the Visible on Product View Page on Front-end to control if this attribute shall be shown on the Product View Page.
  4. Use the Manage Label/Options tab to set labels and options for the attribute as you need it.




Assign the Attribute to Attribute Set

Assign the new attribute to the Attribute Set you are using for your products using Catalog » Attributes » Manage Attribute Sets. Select the attribute set you use for your Downloadable Products and drag/drop the new attribute to the General group. You may use any position, the ordering of multiple such created attributes is according to the order of the attributes in this group:

Your custom attribute will then be used for the Downloadable Links. In case the attribute shows also in the General tab of the product, leave it blank there (or you may use it for the general part of the product.
The attribute values for each of the Downloadable Links are stored in a separate database table, and consequently are then independent from the product itself.

To show these link attributes on the product page, add the related widget to your stores frontend template:



For replacing already purchased Downloadable Links with new Downloadable Link:

  1. Create a new Downloadable Link and select the Downloadable Links to be replaced by this new Link from the This Link replaces list:

  1. Save and Continue to edit the Product, the Downloadplus will create an internal cron-job to update all Purchased Downloadable Links from the customers using the selected This Link replaces links to use the added Link instead.
  2. If you want to remove the Downloadable Links which are replaced by this new Link then remove them now from the Product.



In the Customer Account for his purchased Downloadable Products the following is done by DownloadPlus:

  1. Only non-expired purchased Downloadable Links are updated to use the new Downloadable Link.
  2. The update does expire the original purchased Downloadable Link, and is adding a new purchased Downloadable Link with the resource set to the new Downloadable Link.
  3. Date expiration is taken over from the original purchased Downloadable Link.
  4. Number of used Downloads is reset to 0, and the number of available Downloads from the new Downloadable Link are used for the new purchased Downloadable Link.


By this the customer and you have a transparent history of the purchased Downloadable Links and no original purchased Downloadable Link is deleted (only set to expired). The replacement Link shows in the customers My Downloadable Product as a regular Downloadable Link associated to his orders.

Using this function requires an active CRON configuration for your Magento Store, please see the Magento Documentation here for how to configure the required CRON job...



If you want to use Custom Attributes for the Additional Product Downloads on product types other than the Downloadable Product create the Custom Attribute as described Custom Attributes for Downloadable Links in above but do the following different:

  • Use the prefix downloadable_additional_ for the Attribute Code to identify it for DownloadPlus as attribute related to the additonal Product Download.
  • Apply the attribute to the Product Types where you want to use it, or to All Product Types.


The newly created Attribute is then available in the Additional Downloads tab of the Products defined for the Attribute to be used (as example see the Logo textbox below):

DownloadPlus extends the Manage Products page to allow to add Version Number and Description (as Version or Release Notes) to the Downloadable Files. This view has the following areas:

  • Current Downloadable Files … The files related to active and current Downloads.
  • Historical Downloadable Files … The files DownloadPlus was able to track as historical files related to Downloads, where this file has been superseded by a newer file that has been uploaded to the Link or Sample.
  • Add other available historical Downloadable Files … Shows files that are currently not associated with active Downloads. These are historical files that may get added to this product as historical file.



Each file has extended data that allows to add details that will be used to build the Archive Information shown on the download pages DownloadPlus generates:

  • Related To … Allows to select to which Downloadable Link, Link Sample or Sample this file shall be related to. Use (Remove Association) to remove the file from being associated to the current Product and its Downloadable Links.
  • Size & Date … Informational for the files current size and date.
  • Version … Allows to add a Version Stamp to the file.
  • Description … Allows to add a Description to this file, to be used for special Release Notes or Upgrade Instructions or such.
  • Hide this File on Frontend … Allows to hide this file in the Version History of the Product Catalog on the Store Frontend. Use this to reduce your public visible File History. Files set as hidden will be shown with strike-through on the filename here in the Product Edit page.



The data defined here is used for the Terms of Use page and Download Archive shown in the Frontend.

When having finished editing these File Details, either use Save or Save and Continue Edit to save your changes.

When doing a update of your files for Links or Samples, always perform that file upload before editing the Download Details. Use Save and Continue Edit after uploading files to your product, and then edit your Download Details. That way DownloadPlus will be able to track the changes and your uploaded files will show up too in the Download Details.

Always UPDATE the files of your Downloadable Links and Samples to keep the Version History by uploading your new Version to the existing Link or Sample entry. In case you delete a Downloadable Link or Sample, its Version History will be closed and is not available for any new created Links or Samples.


Catalog » Manage Products



To add older files to this Product as historical Files use the Panes of Add other available historical Downloadable Files and select the files you want to add as historical files to your current product. Use Save and Continue Edit to update your selection and to add the marked files to the Historical Downloadable Files.

Magento stores the files for Links, Link Samples and Samples in different directories. That allows to have these files already identified in their general association. Use Related To to relate a individual file to a individual downloadable Link, Link Sample or Sample after having it added to the Historical Downloadable Files.



As to the structure of Magento, DownloadPlus only allows one specific way to maintain Versions of Downloadable Products. The following description shows how to organize your Downloadable Products that is comaptible with the functions DownloadPlus is adding to your Store:

Adding Versions when creating a new Downloadable Product

  1. Choose one of your existing or create a new Downloadable Product

  2. Add the oldest Version of your File as Downloadable Link, use “Upload File” to upload it to your Store:
  3. Use “Save and Continue Edit” to save your current Product Status

  4. For any newer Version of your File, update the related Downloadable Link and upload the File to it and by that adding that newer Version to the File Repository of your Store:
  5. Always “Save and Continue Edit” to save your current Product Status between updating files

  6. When proceeding in that manner, DownloadPlus will be able to track the Versions for the particular Download Link:



The same approach needs to be taken also for Downloadable Samples or Downloadable Link Samples.



Adding Versions for existing Downloadable Products

  1. Upload any previous Version of existing Downloadable Products to your Store's server using FTP or other means of File Transer

  2. The default target directory is media/downloadable/files and the respective subfolder links (for Downloadable Links), link_samples (for Downloadable Link Samples) and samples for Downloadable Samples.

  3. When having already files in one of these repositories, you may recognize that for each of the FIRST TWO characters of the filename, a subdirectory structure is created. Where the respective file then is located: v/e/version-1.zip, v/e/version-2.zip, s/o/some-other-file.zip
    You may need to create the new folder tree for your new file if it is not already existing.

  4. After having manually uploaded older Versions of your Downloadable Products, Use Manage Products to add these Historical Files to your Products as described above.


See also the configuration option Behaviour for Downloadable Products to select if the customer receives the most recent file or the file he has purchased when using the Download Link he received with the Order Invoice email.



DownloadPlus allows to define a expiration duration in days for individual downloads of a Downloadable Product. To define the expiration behaviour of a downloadable file first create all the downloads for the downloadable Product and the use Downloadable Settings to define the behaviour for expiration of all or a single download on the downloadable Product:



When defining a maximum number of downloads the expiration of the download and the limit of downloads are concurrent, meaning that the related download will be set to expired upon whichever limit comes first.

The related expiration date for a purchased Downloadable Product is set at the purchase (or at the first download depending on the choosen option) and is fixed afterwards. When changing the expiration duration at any later point in time here, past purchased Downloadable Products will be unaffected by that change as the expiration duration set at purchase is always used for the purchased download.

The individual settings for the downloads are:

Expiry in days

Sets the expiry of the download in days.

When to start expiration

Allows to select when the expiration of the downloadable file will start:

Never expire

Will set the download to never expire, the default Magento behaviour.

Start expiry on order

Will start the expiration with the date of the availability of the download at order placement with the order in status “Complete”.

Start expiry after first download

Will start the expiration with the date of the first download with the order in status “Complete”.

DownloadPlus extends the Customer Information page with a view of the customers Purchased Downloadable Products. By default the Purchased Downloadable Products is shown in the Customer View:


In case your Customer Information is missing the Customer View Tab, you may need to add that tab by modifying the default Customer Information page...


The Purchased Downloadable Products are also available as separate Tab of the Customer Information, to enable this tabbed view modify the layout file as described here...


This view allows you to:

  • Manually set the Downloadable Link Status.
  • Manually set the Download Limit on the number of Downloads.
  • Manually set the Download Limit on time expiration.


The options for manually setting the Downloadable Link Status are:

  • pending, pending payment, available, expired as per the general status available from the Order Status.
  • Reset Download will reset the Downloadable Link to the limits currently defined for the Downloadable Link in the associated Product.
  • Update && Reset Download will update the link resource (URL or File) to the current link resource defined in the associated Product and resets all limits as in Reset Download.


For this to fully work and to show the Date of the last recorded download, the Tracking of Downloads is required to be active.



DownloadPlus allows to add Serial Number data to any purchased Product of a Customer. The status of the Serial Number is kept synchronized with the related downloadable Product and its status.

To make full use of this feature, you may need to add also the related Account page to your store template.


Customers » Manage Customers » Customer Account » Current Downloads


How to add Serialnumbers
  • Select the related Order from 'Related to Order & Product'.
  • Enter a Title for the Serial Number into the Title field.
  • Put the Serial Number into the related field.
  • Select 'Notify Customer' to send a transactional Email to the Customer notifying him on the availability of the Serial Number. See also the Transactional Email for new Serial Number for more on this.
  • Use 'Add new Row' to add a new row for a Serial Number.
  • To remove a Serial Number, use the 'Delete' button at the right of the related row.
  • Use 'Save and Continue' to save your changes. Also use 'Save and Continue' if only having checked the 'Notify Customer' to send the related Transactional Email.


DownloadPlus allows to add a pool of serialnumbers to any Product. Any order of the product will automatically assign a serialnumber to the purchased product or the customer.

Email notification to a configureable email address are sent when:

  • The number of available serialnumbers falls below a limit.
  • A order has been made and there are no serialnumbers available for the product anymore.

Also see the related configuration options to setup these notifications here...

To make full use of this feature, you may need to add also the related Account page to your store template.


Customers » Manage Products » Product » Serialnumbers


To automatically assign serialnumbers during your customers purchases, set the following configuration option to Invoiced:

System » Configuration » Catalog » Downloadable Product Options




One-line serialnumbers are supported with a maximum length of 65535 characters, meaning each serialnumber is one line of text in the textarea as shown in the above example.
Enter your serialnumbers or paste the serialnumbers into the “New Serialnumbers” field and use “Save and Continue Edit” to import the serialnumbers into the pool for this product.

After import the currently available serialnumbers are listed below in “Serialnumbers available for this Product”. A single serialnumber assigned to a customers order will get removed from the pool once assigned.

To start the automatic assigning of serialnumbers you need to import a initial set of serialnumbers to your product. Only then the related notifications and assignments are being made by the extension.



When importing Serialnumbers after a Notification that Serialnumbers are used up for a Product, an automated Job (scheduled every 6h) will automatically assign Serialnumbers from the fresh import to Order Items where the Serialnumber was not assigned at purchase. This requires your Magento Store to have an active CRON-Job. To manually start this procedure you may use the AOE Scheduler Extension and start downloadplus_cron_jobs manually.

You may create pools for serialnumbers to allow individual downloadable items to pull the serialnumber from the respective pool. Per default all serialnumbers are imported to the whole product being shared for all downloadable items of the product.

To assign serialnumbers on import to a new named pool, enter the name of the pool to create in the input field Add to new pool. Or select a existing pool from the drop-down list Import into existing pool to import serialnumbers into a existing named pool.



Serialnumbers are taken from the imported data whenever a sale is complete and then assigned to the related downloadable link. In the Tab Downloadable Settings select the serialnumber pool from which the serialnumber for orders shall be taken:



To select individual downloadable links to be excluded from assigning serialnumbers, select - Do not assign Serialnumbers for that link:



To remove one or multiple serialnumber from the pool of available serialnumbers, please check the Remove checkbox on the serialnumber entries to be removed and use Save or Save and Continue to delete the selected serialnumbers from the pool.



In addition to creating product related Serialnumber-Pools as shown above, you may also create global serialnumber pools and assign individual downloadable links to these for assigning order serialnumbers from.

To create such global pool, use Catalog » Import storewide serialnumbers to create a global pool and import serialnumbers into it:



Import new serialnumbers and create pools as described above for the product related serialnumbers, use the Import Serialnumbers button the start importing. To view available storewide shared serialnumbers use the Available Serianumbers button.

Please use a name not used in Serialnumber Pools for products as name for a Global Serialnumber Pool, a related error message may be shown if you try to name a Global Serialnumber Pool the same as a pool name already used in a product.


To receive a list of serialnumbers which are assinged to orders use:
Sales » Serialnumbers



In this list you may use the filters to find a particular order based on the serialnumber, each list item is linked to the related order.

Whenever an order has assigned Serialnumbers for a Product, DownloadPlus will generate alerts whenever the pool of available Serialnumbers for that product will become empty of available Serialnumbers. To deactivate assigning of new Serialnumbers to the product the following option needs to be set to Yes:


DownloadPlus allows to add Files or URLs to any purchased Product of a Customer, just as known from the Downloadable Product itself. The status of the additional Downloads is kept synchronized with the related purchased downloadable Product and its status.

Using this feature allows to add License Files, or URLs to licensing sites for a specific customer purchased downloadable item.

To make full use of this feature, you may need to replace the My Downloadable Products page for the Customer Account in your store template.


Customers » Manage Customers » Customer Account » Current Downloads


  • Select the related Order from 'Related to Order & Product'.
  • Enter a title for the additional Download in the Title field, also a field for a Description is available.
  • Select 'Notify Customer' to send a transactional Email to the Customer notifying him on the availability of the additional Download. See also the Transactional Email for new Additional Download for more on this.
  • Set the number of 'Maximum Downloads' in the related field, or select 'Unlimited' to allow unlimited numbers of downloads for this File or URL.
  • Set 'Shareable' to Yes to allow shared access to the related download link, or No to force login to the Customer Account before allowing download of this link.
  • Use 'Add new Row' to add a new row for a additional Download.
  • Upload the related file by selecting and using 'Upload' to upload it, or enter the related URL to use for this additional Customer Download.
  • To remove a entry, use the 'Delete' button at the right of the related row.
  • Use 'Save and Continue' to save your changes. Also use 'Save and Continue' if only having checked the 'Notify Customer' to send the related Transactional Email.


When uploading Files with an already existing name, such files will overwrite the existing file stored in the Customer Account. Files are stored for each Customer Account in separate to avoid collisions between Customer Accounts.



DownloadPlus allows to add Files or URLs to any Product in the Catalog, just as known from the Downloadable Product itself. Difference with this is that these Additional Downloads are public and shown on the Catalog page of the Product (when having added the related block to your store template).

Using this feature allows to add Manuals, Software or other supplemental Files, or URLs to other sites to a specific Product. And have these show in the Catalog page of the product as available for public download. This Feature is also available for the 'Downloadable Products' to add free downloads to such Product Type.

To make full use of this feature, you may need to show the Additional Downloads in the Catalog Product Page in your store template.

You may also use Custom Attributes on the Additional Downloads, see here how to add customer attributes for the additional downloads.

Catalog » Manage Products » Product » Additional Downloads


  • Enter a title for the additional Download in the Title field, also a field for a Description is available.
  • Select Yes on the 'Download requires registration' option to force a Visitor to register or login first before being allowed to access this download.
  • Use 'Sort Order' with a numeric value to set the Sort Order for the individual additional download links.
  • Upload the related file by selecting and using 'Upload' to upload it, or enter the related URL to use for this additional Customer Download.
  • Use 'Add new Row' to add a new row for a additional Download.
  • To remove a entry, use the 'Delete' button at the right of the related row.
  • Use 'Save and Continue' to save your changes.


Additional Product Downloads are tracked if the configuration option Track Downloads for Downloadable Products is set to Yes.

When uploading Files with an already existing name, such files will overwrite the existing file stored in the Product. Files are stored for each Product in separate to avoid collisions between Products.



DownloadPlus adds statistics pages to your Magento Store Administrator. These show the totals of Downloads under the Download Dashboard, and the Download Log with tracking data for each single download (if set to be tracked):

The Download Dashboard show an overview of the logged Downloads. To view the details to it, as well as the full log continue over to the Download Log.

Catalog » Downloads


The Download Log tracks the downloads as configured in the related configuration options for Tracking of Downloads. Clicking on a log entry row will take you to the related Product. If a customer was logged-in during downloading, then a link to the Customer Account allows to directly open the related customer account.

Catalog » Downloads » Download Log


Directly in the customer account the tracked downloads for this customer are available as well in the Current Downloads tab: