File Downloads & Product Attachments by MageWorx

Free
Available
SKU
file-downloads

File Downloads allows you to attach downloadable files (price lists, user guides, warranty agreement, video tutorials, etc.).

ScandiPWA is a headless application and it requires a compatibility extension with conventional Magento 2 extensions to serve them for PWA applications. Specifically, it provides a GraphQL and React component to let the client-side render the application to be able to interact with the back-end of the extension. ScandiPWA rewrites Magento front-end, so it needs to replace the front-end layer of a usual Magento 2 extensions and this extension is providing exactly this.

DISCLAIMER

To get the functionality of the extension you will need both ORIGINAL extension to be installed in Magento and also PWA extension to be installed in ScandiPWA theme.

Original extension URL: https://support.mageworx.com/manuals/download/

ScandiPWA version: 3.0.0-stable
ScandiPWA Compatibility
 

Introduction

File Downloads & Product Attachments allows you to attach downloadable files (price lists, user guides, warranty agreement, video tutorials, etc.).

You can share the attachments on Product Pages, in Static Blocks or literally on any CMS page. The extension provides the possibility to attach files in all popular file formats, such as: jpgjpeggifpngbmptxtcsvhtmhtmlxmlcssdocdocxxlsrtfpptpdfswfflvaviwmvmovwavmp3zip and many others.

The access to the files can be restricted for different customer groups. The access to the files can be restricted for different customer groups. By hiding attachments behind the You have to login or register to download this file message you can motivate customers to sign up/log in.

 

Requirements and Installation

File Downloads and Product Attachments extension supports Open source (Community), Commerce (Enterprise) editions and Commerce cloud. The current version of the Magento installed on your website can be found in the lower right corner of any backend page.

File Downloads and Product Attachments has 3 separate ways of installation:

1) Copy the code (ready-to-paste package);
2) Use MageWorx Repository;
3) Use local Composer.

 

Configuration

The main extension’s settings can be found under STORES ⟶ Configuration ⟶ MAGEWORX ⟶ File Downloads & Product Attachments

File Downloads Configuration

Display File Size shows/hides the file size that comes next to the downloadable file.

File Size Precision displays the file size in one of 3 values: KilobytesMegabytes or Auto. We generally recommend users to set it to Auto.

Group By Section groups files by sections and displays the section name on the front-end.

Sort Order arranges files in one of the following sequences: AlphabeticalUpload DateSizeNumber of Downloads.

Hide Files - if set to Yes, then the user won't see the attachments that are set up to be shown for some other customer group. if this setting is set to No, then customers will see the files as a plain text but won’t be able to download them unless they are able to change their customer group.

'How to download' message is a dependable option and is shown in case the Hide Files setting is set to No. This message provides some hints on how to change the customer group. The most obvious example is restricting the non-registered users from downloading the attachments. Therefore, this message can persuade the user to Log in or Register. The variables can be used here like %login% or %register%.

Display the # of Downloads shows visitors how many times the file was downloaded.

Example

 

Here, the Display File Size is enabled, Hide Files is set to No and the second attacment is prohibited to download for the non-registered users. The 'How to download' message is shown for this attachment. The Display the # of Downloads is set to Yes

 

 

File Downloads Configuration

Product Downloads Tab Title provides the default tab title shown on the product page.

Product Downloads Block Title specifies the default tab title shown on the product page.

Example

 

Here, the Product Downloads Tab Title is "File Downloads Tab" and the Product Downloads Block Title is "File Downloads Block"

 

 

Maximum Allowed File Size allows to limit the size of the uploaded files.

File Downloads Title is the default title that is shown on the CMS Pages if it is not specified as explained here.

 

File Downloads Sections

To check or modify file downloads sections, go to STORES ⟶ MageWorx Downloads ⟶ Manage Section

File Downloads Sections

In this section, the store owner can manage all the sections:

- add new ones;

- edit the existing sections;

- bulk enable/disable them;

- select and delete the ones that are not needed.

- To create a new section, click the Add New Section button.

File Downloads Sections Configuration

Here you can specify a Section Name (it can be visible on the front-end for your customers)Short Description (optional and not visible on the frontend) and the Status (enabled by default).

 

File Downloads Attachments

To check or modify file downloads sections, go to STORES ⟶ MageWorx Downloads ⟶ Manage Attachments

File Downloads Sections Configuration

In this section, you can add a new product attachment, edit the existing ones or delete the files you no longer need.

This grid supports Mass Edit. To manage the bulk configuration, the store owner should select the checkboxes of the products and click the Edit button in the Select Items dropdown.

File Downloads Sections Mass Edit

To add a new section, click the Add New Attachment button.

File Downloads New Attachments

First of all, the store owner should select the desired Section for the attachment, specify the Name and the Description (will be visible on the frontend).

Example

 

The "Mageworx License" is the attachment's name and the "Default Magento License (Description)" is the description of this document.

 

 

Downloads Limit determines the max number of allowed downloads for the certain file. If the limit is exceeded, customers won’t be able to download this file.

Assign By spesifies the way how to assign the products to this attachment. Depending on the selection, the second tab of the Attachment page will differ.

Example

Product grid: The Product Grid option is the default one. Here, one can see the default products grid with the possibility to use the standard Magento filters functionality to easily find the necessary products. File Downloads New Attachments

Product SKUs / IDs: You can also assign templates to products by entering their Product IDs or Product SKUs. Each individual ID/SKU should be comma-separated. File Downloads New Attachments

 

Note: no spaces allowed between multiple values.

File / URL Switcher provides the possibility either to upload the files to the server from the computer or from any location on the web via URL. If the File is selected, you can assign as many files as you wish at once. The maximum allowed size of one file is 10 Mb. If the URL is selected, then the file will be opened in a new browser tab.

Customers Groups allows choosing customer groups that can download or view the files.

Store View manages the store views, where the attachments should be visible.

Is Active setting provides the possibility to temporary hide this attachment.

Add file in "New Order" email allows adding the downloadble files to the order confirmation emails.

 

Downloads on the Product Level

Go to PRODUCTS ⟶ Inventory ⟶ Catalog, click on the desired product and select the Attachments tab.

File Downloads Product Attachments

From here, the store owner can add a new attachment by clicking the Add New Attachments button. This will show the same workspace as in the Manage Attachments section.

Add Attachments button allows to select the existing attachments that have been uploaded in the "Manage Attachments" section.

File Downloads Product Attachments

This shows the attachment grid with the possibility to manually select the desired ones. Click the Add Selected Attachments to apply them to the product.

Be sure to click the Save button on the Product Edit workspace to apply the changes.

 

Attachment Widgets

Displaying the attachments via the Magento 2 widgets give you the flexible functionality to insert the file attachments on any page of your store, including the pages of 3rd party solutions (if they support Magento 2 widgets).

The extension adds 2 new types of Magento 2 widgets:
Attachment Sections - this type of widget allows displaying the sections of the attachments.
Attachments - this type of widget allows displaying the attachments.

To create a new widget go to CONTENT ⟶ Widgets and click on "Add new widget" button. Then you should choose either "Mageworx Attachment Sections" or "Mageworx Attachments" widget type and a theme you want to insert this widget to.

The "Storefront Properties" section is standard Magento 2 section. Here you can set the general parameters of the widget and define the pages you want to add this widget to.

The "Widget Options" section allows you to choose whether you want to display all attachements/sections or specific ones only.

 

Product Attachments on CMS page

Go to PRODUCTS ⟶ Inventory ⟶ Catalog and select the desired page.

File Downloads on CMS page

Add the following code to the body of the page:

{{block class="MageWorx\Downloads\Block\Links" id="2,1" title="My files"}}

where

id – ID numbers of the files you need to display. They can be found out in the attachments grid. Use all instead of numbers for all the products.

title – a title of a block with the files on a CMS page.

File Downloads on CMS page

The way how this block will be seen on the frontend.

 

It is also possible to add all the attachments assigned to some section by adding another code:

 

{{block class="MageWorx\Downloads\Block\Section\Links" id=“2,1" title=“My files”}}

where

 

id - ID numbers of the section you need to display. They can be found in the sections grid. Use all instead of numbers for all the products.

title – a title of a block with the files on a CMS page.

 

Product Attachments on the Category Page

Go to CATALOG ⟶ Categories and select the desired category.

File Downloads Product Attachments

In the Design section paste this code:

 

<referenceContainer name="content">
   <block class="MageWorx\Downloads\Block\Links" name="catalog.product.list.mageworx.downloads.attachments" as="mageworx_product_attachments" template="MageWorx_Downloads::attachment_container.phtml" group="detailed_info">
       <arguments>
           <argument name="id" xsi:type="string">2</argument>
           <argument name="title" xsi:type="string">Titolo blocco</argument>
       </arguments>
   </block>
</referenceContainer>

where

 

<argument name=“id” xsi:type=“string”>1</argument> has the ID numbers of the files you need to display. They can be found out in the attachments grid.

<argument name=“title” xsi:type=“string”>Titolo blocco</argument> is the title of a block with the files on a CMS page.

 

Product Attachments On the Third-Party Themes Product Pages

Several third-party themes have the possibility to add the CMS block on the Product tab. If this is possible, create the block and add this code:

{{block class="MageWorx\Downloads\Block\Catalog\Product\Attachments" template="MageWorx_Downloads::attachment_container.phtml"}}

File Downloads on CMS page

Select this block in the theme's configuration as the product tab block.

 

Import/Export

 

Import/Export Sections

The extension has the possibility to export the downloads sections and to import them. Log into the Magento Admin panel and go to SYSTEM ⟶ Data Transfer ⟶ Import/Export Sections.

File Downloads Sections Configuration

To check the structure of the CSV document, click the Export button or the Download Example CSV.

The structure of the CSV is as follows:

"Name","Short Description","Status"
"Default","You should already have the 'Default' section.","1"
"Manuals for HP Laptops","Manuals for HP Laptops (4xxx series)","1"
"Manuals for Dell Laptops","Manuals for HP Laptops (alienware series)","0"

The values of the Status can be either 1 (for the enabled section) or 0 (for the disabled one).

If you have our Magento 1 File Downloads & Product Attachments, you can export the categories (sections) from Magento 1 and then import the CSV file to Magento 2 installation. For this, log into the Magento 1 admin panel and go to CMS ⟶ File Downloads ⟶ Manage Categories and click the Export button:

File Downloads Sections Configuration

This CSV is the one that you should upload to the Magento 2 installation.

For the upload of the CSV file, click the Choose File button, select the CSV file and click the Import Sections.

 

Import/Export Attachments

The extension has the possibility to export the downloads attachments and to import them. Log into the Magento Admin panel and go to SYSTEM ⟶ Data Transfer ⟶ Import/Export Sections.

File Downloads Sections Configuration

To check the structure of the CSV document, click the Export button or the Download Example CSV.

The structure of the CSV is as follows:

"Section","Name","FilePath","URL","Description","Products","CustomerGroups","Stores","DownloadsLimit","Status"
"ManualsforHPLaptops","HP4720manual","HP/hp_4x20.pdf","","ManualsforHPLaptops(4xxxseries)","HP4520|||HP4720","General|||Wholesale","all","50","1"
"ManualsforDellLaptops","ManualsforDellLaptopshere","","https://drive.google.com/drive/folders/0B3k2yE04lnZ","","Area-51m|||m17","all","us_store","","1"

For any separate attachment the store owner should populate either FilePath or URL value. The FilePath is the relative file path from the base location of the uploaded attachments which is /pub/media/mageworx/downloads/import. So for the HP/hp_4x20.pdf the full server path of the PDF file is /pub/media/mageworx/downloads/import/HP/hp_4x20.pdf.

Note: you need to upload the attachment files to the /pub/media/mageworx/downloads/import folder before uploading the CSV file.

The Products block is the list of the SKUs that should be associated to this attachment file. The separator here is |||, so HP4520|||HP4720 actually means two products: HP4520 and HP4720.

For the CustomerGroups, you can use ||| as the separator for several customer groups or all for all customer groups.

The values of the Status can be either 1 (for the enabled attachment) or 0 (for the disabled one).

When the CSV file is being uploaded, the system may observe the problems preventing the correct connections of the products to the files. The store owner can put the checkbox for the Skip Product Checks setting for the situations when the SKU in the Products section is not found. The Skip File Checks setting allows ignoring the import of the attachment if the extension fails to find the file.

If you have our Magento 1 File Downloads & Product Attachments, you can export the files (attachments) from Magento 1 and then import the CSV file to Magento 2 installation. For this, log into the Magento 1 admin panel and go to CMS ⟶ File Downloads ⟶ Manage Files and click the Export button:

File Downloads Sections Configuration

Next, you need to transfer the file attachments from the Magento 1 installation to the Magento 2. For this, connect to your Magento 1 server via any FTP client and go to media/downloads. Copy all files and subfolders to the pub/media/mageworx/downloads/import on your Magento 2 server.

The exported CSV is the one that you should upload to the Magento 2 installation.

For the upload of the CSV file, click the Choose File button, select the CSV file and click the Import Attachments.

More Information
ScandiPWA Version 3.0.0-stable
Magento Version 2.3.5 CE
Product Name File Downloads & Product Attachments by MageWorx
Original Extension URL https://support.mageworx.com/manuals/download/
Short Description

File Downloads allows you to attach downloadable files (price lists, user guides, warranty agreement, video tutorials, etc.).

Write Your Own Review
You're reviewing:File Downloads & Product Attachments by MageWorx
© 2020 ScandiPWA Marketplace. All Rights Reserved