Firefox user notice:

Please use another web browser to view this document.

Sorry for the inconvenience.

1. Backup your web directory and store database

2. Download the Product Downloads installation package

 3. Upload contents of the Product Downloads installation package to your store root directory

cd path_to_the_store_root_folder

php -f bin/magento module:enable Aheadworks_ProductDownloads

php -f bin/magento setup:upgrade

php -f bin/magento setup:static-content:deploy

5. Flush store cache; log out from the backend and log in again

Make sure the installation is done from the FTP administrator account. Otherwise, set 775 permissions to the store root directory after the extension is deployed.

1. Login to your ssh console and navigate to your store folder:

Run the following command:

On successful execution of the command you will be able to use the composer to install the extensions.

composer require aheadworks/module-product-downloads

composer require aheadworks/module-product-downloads:<version>

Specify the version of the extension in <version>

When prompted, enter Public Key (Username) and Private Key (Password):
Image Removed

Both Public Key (Username) and Private Key (Password) can be found in My Projects and Licenses in your personal account on our site:

Image Removed

4. Enable the extension:

php -f bin/magento module:enable Aheadworks_ProductDownloads

Next, register the extension:

bin/magento setup:upgrade

Recompile your Magento store if you are in the Production mode:

bin/magento setup:di:compile

To verify that the extension is enabled, run this command:

bin/magento module:status

Clean store cache, by running the following command:

bin/magento cache:clean

Log out and Log in the backend again.

composer update aheadworks/module-product-downloads

composer require aheadworks/module-product-downloads:<version>

php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

crontab -e

*/3 * * * * php -c <ini-file-path> <your Magento install dir>/bin/magento cron:run
*/3 * * * * php -c <ini-file-path> <your Magento install dir>/update/cron.php
*/3 * * * * php -c <ini-file-path> <your Magento install dir>/bin/magento setup:cron:run

SVG files are not supported by the current version of the extension. Reason: Magento 2 does not validate SVG files.

If your Magento 2 theme does not presume a side-bar on product pages, you will not be able to see the Product Downloads block on the Storefront. 

Icons, indicated herein, are automatically assigned to the product attachment files when the latter are uploaded to the store. This is done in compliance with the types of the files as indicated in the table herein.

Monitoring Files

To view the product attachment files uploaded to your Magento 2 store, go to Catalog > Product Downloads by Aheadworks > Files.

The page suggests the Files Grid, Add New Attachment and Synchronize Attachments buttons.

The Files Grid aggregates the details about all uploaded to the system product attachment files. The grid has the following columns:

• ID - identification number of the file;
• Icon - the thumbnail of the file image;
• Name - the name of the file, including the file-type;
• Number of Downloads - the number of times the file has been downloaded;
• Visible - the status of file visibility on the Storefront: Yes/No;
• Customer Groups - the groups of customers eligible to download the product attachment file;
• Action - the Edit active link to lead to the Edit File page.

The grid is sortable and supports pagination.

Image Removed

Adding Files

There are four ways of adding product attachment files to the system:

• Via a product page (multiple files can be uploaded);
• With the help of the Add New File button on the Files page (one file is uploaded at a time);
• Import  products and product attachment files (multiple files can be uploaded)
• Uploading files straight to the server (multiple files can be uploaded).

Add Files to FTP

Upload files to media/aw_pd/files. When files are uploaded onto the ftp-server, they will automatically get represented in the Files grid. This requires re-indexing the database, which can be done in two ways:

1. Wait for the next planned index update by the cron;
2. Go to Catalog > Product Downloads by Aheadworks > Files and click the Synchronize Attachments button.  

Add Files to Files Grid

To add files one-by-one to the Files grid, go to Catalog > Product Downloads by Aheadworks and click on the Add New Attachment button.

The New File page will get loaded, similar to that of Edit [Name] File. The New/Edit File page has the following parameters for configuration:

• Type - the File/URL selector to define the source of the file;
• File (when Type → File is selected) - the upload button, the file preview window, file name and size, the bucket active icon to delete the file;
• Link (when Type → URL is selected) - the text-box to welcome the url of the file;
• Customer Group - the list of the groups of customers eligible to download the product attachment file (multi-select is possible);
• Is Visible - the Yes/No toggle to define if the file is visible on the Storefront. 
• File Name - the text-box to indicate the name of the file as it will appear on the Storefront.

Click Save in the top right when finished to save the configuration of the file and add it to the Files grid.

Image Removed

Attach Files to Products

To attach files to a product, proceed to Catalog > Inventory > Products and select a product for editing. When the Product page is loaded, scroll down to the Product Downloads section.

The Product Downloads section allows attaching multiple files to the product. The Admin can attach either existing files or upload new ones. The section delivers the functionality to attach files and to browse the files which have already been associated with the product. The latter is done with the grid located at the bottom of the section.

The grid with the attached files has the following columns:

• ID - identification number of the file;
• Icon - the thumbnail of the file image;
• Name - the name of the file, including the file-type;
• Visible - the status of file visibility on the Storefront: Yes/No;
• Customer Groups - the groups of customers eligible to download the product attachment file;
• Action - the Edit active link to lead to the Edit File page.

The grid supports pagination and allows re-arranging the order of the rows. The latter is needed to set the order of the files on the Storefront. To re-arrange the order of the rows, make use of the icon next to the ID of the file. Push on the icon, and drag-and-drop the row to the new position. The grid will get populated as files are being attached to the product.

Image Removed

To attach files which have already been uploaded to the system, click on the Select Existing File button. The Select Files popover will emerge. The popover fetches the Files grid with check-boxes next to each row. Tick the check-boxes which correspond to the chosen files and click on the Add Selected Files button below the grid. The popover will get closed, the files will be added to the product, and the Product Downloads sections on the Product page will get updated.  

Image Removed

To attach files which have not yet been added to the system, make use either of the "Click here or drag-and-drop files" area or the Add a Link text-field. Files attached to a product this way, will automatically populate the Files grid and will receive default values for the following parameters:

• Icon - the icon image as per the Manage Icon section in Extension Configuration;
• Visible - Yes;
• Customer Groups - All groups;
• File Name - the name of the upload.

You can add multiple files in one go with the help of the 'Click here or drag-and-drop files", but only one file at a time with the help of Add a Link. To do so, insert a link into the Add a Link text-field and click on the Add Link button. 

Import/Export Files

To import product attachment files to the system, go to System > Data Transfer > Import and perform the operations as described in the official Magento 2 user-guide. 

When on the Storefront, customers are able to see product attachment files on product pages in one of the three alternative locations (as set in the Extension Configuration) under the block-title and in the order as set on backend. To download a file, customers click on the name of the file.

Image Removed

php bin/magento module:disable Aheadworks_ProductDownloads
php bin/magento setup:upgrade

app/code/Aheadworks/ProductDownloads

php bin/magento module:uninstall Aheadworks_ProductDownloads