Product Downloads and Product Links
Product information "Product Downloads and Product Links"
Highlights
Product downloads as a link or with image, including title & description Flexible placement: separate tab or no tabÂ
Features
Import also possible via API interfaceÂ
Product Downloads
- Downloads of files at the article
- offer explanations, software and manuals
- Formats like JPG, GIF, PNG and PDF possible
- In Shopware Standard, the following file types are possible for file upload in Media Manager:
jpg, jpeg, png, webp, gif, svg, bmp, tiff, tif, eps, webm, mkv, flv, ogv, ogg, mov, mp4, avi, wmv, pdf, aac, mp3, wav, flac, oga, wma, txt, doc.
If you want to upload special documents with other extensions, then this will be blocked by Shopware
A simple adjustment of the Shopware configuration file makes this possible:
Starting from the Shopware root > config > packages > shopware.yamlÂ
(edit if present, create if not present - this is a simple text file and can be edited with a Notepad++ or similar)
Please copy this entry in or adjust entry accordingly:
shopware:
filesystem:
allowed_extensions: ["jpg", "jpeg", "png", "webp", "gif", "svg", "bmp", "tiff", "tif", "eps", "webm", "mkv", "flv", "ogv", "ogg", "mov", "mp4", "avi", "wmv", "pdf", "aac", "mp3", "wav", "flac", "oga", "wma", "txt", "doc"] - We have created a plugin to extend the file extensions without manual adjustment of shopware.yaml - you can request this from us for free via support.
Product links (from plugin version 3.x)
From plugin version 3.x we have created the possibility to manage links.
Here links can be displayed in different positions (e.g. show link in own tab, link tab before or after ratings, show link in no tab,...).
Links can be provided with a title and a description, it can also be set whether the link should open in a new tab.
Basic setting
Via Settings > System > Plugins > AcrisProductDownloads
Set the position of the download products
Enter media path for import
Configuration
A module for download articles is offered in the product with downloads
As with media, files can be stored there.
Images and files can also be uploaded directly via a URL
Title, description and position of the files can be changed later
The download files can be displayed in different position
- In a separate tab
- Before the description
- Between the description and the technical data
- According to the technical data
Import via Shopware API -Â API Documentation
1. Uploading the downloads via FTP
First, an FTP path must be entered in the plug-in settings. The download files from the ERP system must be uploaded to this directory.
Example path: file:///var/www/clients/clientX/webX/private/media/documents/
2. Importing the downloads via Sync-API
The JSON call for the sync API:
POST http://www.my-shop.com/api/_action/sync
[
   {
       "action": "upsert",
       "entity": "product",
       "payload": [
           {
               "id": "b851fd3085054856b83e1e693b5bbd1b",
              ...
               "acrisDownloads": [
                   {
                       "fileName": "ACRIS_12345_1_DE.pdf",
                       "title": "Benutzerhandbuch",
                       "position": 0,
                       "languages": [
                           {
                               "id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b"
                           }
                       ]
                   },
                   {
                       "fileName": "ACRIS_12345_1_EN.pdf",
                       "title": "Manual",
                       "position": 0,
                       "languages": [
                           {
                               "id": "01896943f9847021b988cede9f40d445"
                           }
                       ]
                   }
               ]
           }
       ]
   }
]
Field description
- id: Mandatory field. The ID corresponds to the UUID of the product.
- fileName: Mandatory field. Please enter only the file name including file extension. The file must be located on the server in the directory specified in the plug-in settings.
- title: Optional. The title can also be translated analogous to the other translations as they are usual in Shopware 6.
- position: Optional. Defines the display position in the shop.
- languages: Optional. Downloads can be restricted to languages. If languages is omitted or passed empty, the download file is available for all languages.
Replace downloads when re-importing
So that downloads are not assigned more than once when they are imported again, an id (UUID) can also be entered in the "id" field before the "fileName" field.
3. Result
If the download file exists on the server and was found, Shopware imports the file into the media management of Shopware 6 into the folder "Product Media".
If the download file already exists in the media management, it will be replaced.
User guide
Â
- Fixes an issue when loading available languages if they are not assigned to a sales channel.
- Performance optimization when loading product downloads in the storefront.
- Added a new configuration to consider language inheritance when displaying downloads and tabs in the storefront.
- JavaScript warnings have been removed.
- Optimized mobile display of product downloads in the storefront.
- Document title is now prefilled with the file name when creating a new product download in the administration.
- Improved plugin compatibility with Shopware 6.7.
- Improved plugin compatibility with Shopware 6.7.
- Fixed icon compatibility with other plugins.
- Improved plugin compatibility with Shopware 6.7.
- Fixed an importing issue with the "Acris Product Downloads" Profile.
- Improved plugin compatibility with Shopware 6.7.
- Performance optimization when loading product downloads in the storefront.
- Compatibility with Shopware 6.7.
- Support for the following languages: de-DE, en-GB, nl-NL, fr-FR, es-ES, fi-FI, nn-NO, sv-SE, cs-CZ, pt-PT, tr-TR, da-DK, it-IT, pl-PL, bs-BA
- Added a new configuration to consider language inheritance when displaying downloads and tabs in the storefront.
- Document title is now prefilled with the file name when creating a new product download in the administration.
- Fixed an importing issue with the "Acris Product Downloads" Profile.
- Performance optimization when loading product downloads in the storefront.
- Fixed saving product links in different languages.
- Improves Admin product download links listing.
- Fixes the inheritance problem of the variant product with product downloads.
- Fixes a possible problem with preview images for product downloads.
- Fixes a possible problem with the display of product downloads on the product page.
- Improves plugin compatibility with Shopware 6.6.10.* versions.
- Correction of an console error message for products in the administration.
- Optimizes importing of the product downloads.
- Optimizes assigning of the imported downloads to products.
- Improves plugin compatibility.
- Improves plugin compatibility.
- Fixed compatibility with third-party plugins
- Position for links can now be changed in admin
- Position number is now showed in grid for links
- Links are now sorted by position in admin
- Fixed issue where no media was displayed when opening the image selection for the product download preview image
- Fixed "Select Media" button not being shown
- Fixed download element spacings in storefront.
- Improved plugin compatibility.
- Fixed sorting download items in admin.
- Fixes a problem when displaying tabs in the mobile view.
- Compatibility with Shopware 6.6.
- Fixes a possible problem with preview images for product downloads.
- Fixed saving product links in different languages.
- Improves Admin compatibility with previous shopware versions.
- Improves Admin product download links listing.
- Improves plugin compatibility.
- Bugfix fixed edit modal
- Position for links can now be changed in admin
- Position number is now showed in grid for links
- Links are now sorted by position in admin
- Fixed sorting download items in admin.
- Optimizes loading of the downloads from the cache.
- Fixed <a> element title for preview image.
- Fixed <a> element title.
- The media assignment is now displayed correctly for product downloads
- Fixed admin missing rules field
- Improves the logic of the first active tab in the description/rating tabs
- Logic problem when the download tab is displayed first has been fixed
- Optimizes loading of the downloads assigned to the download tab.
- Improved storefront compatibility with other plugins.
- Added Netherlands snippets.
- Optimizes assigning of the documents for the variants.
- Added BundleHierarchBuilder to support AcrisCms integration.
- Compatibility with Shopware 6.5.
- Optimizes loading of the downloads from the cache.
- Added Netherlands snippets.
- Optimizes assigning of the documents for the variants.
- Added BundleHierarchBuilder to support AcrisCms integration for Shopware versions 6.4.
- Change of the plugin name and the manufacturer links.
- Added rules for download tab visibility.
- Adds direct download config.
- Adds download tabs.
- Optimizes displaying of the downloads based on assigned download tab.
- Added new styling configurations for product downloads CMS element.
- Optimizes loading of the product downloads CMS element at the CMS detail page in the Administration.
- Added new "Display layout" setting to plugin configuration.
- Improves compatibility with Shopware >= 6.4.10.0.
- Optimizes downloads and links loading via API search.
- Optimizes loading of the links for product.
- Optimizes links modal in Administration.
- Adds possibility to assign directly link to the product at product detail page in Administration.
- Adds plugin configuration for displaying of the links at Storefront.
- Adds validation on loading of the configured links to the Storefront.
- Fixed a bug with preview images on product detail pages.
- Supporting plugin settings for preview image
- Optimisation of the display in the administration and the display of downloads as a preview image
- Added ability to display downloads with a preview image
- Optimizes converting of the languageIds in product downloads import via Sync API.
- Fixed error when saving product files without title in administration
- Fixed downloads cms element product page bug
- Added downloads cms element and blocks
- Fixes problems with the loading of downloads in listings and checkout for Shopware < 6.4.6.0.
- Optimizes loading of the product downloads.
- Performance optimisations.
- Optimisation of the possibility to load downloads in the checkout and in product boxes.
- Functionality to add downloads in product boxes and the checkout added.
- Optimizes loading of the languages for the downloads.
- Fixes problem on loading media for product download.
- Optimisation for importing downloads via import / export module.
- Optimisation when importing downloads via the Sync API.
- Fix problem on importing of the product downloads.
- Added plugin configuration selection field with display options for downloads in tab.
- Improved compatibility with Shopware 6.4*.
Login
8 reviews
17 December 2025 13:50
Vorbildlicher Support
Sowohl bei aufgetretenen Bugs als auch bei Feature Requests hat Acris wiederholt zügig, freundlich und professionell reagiert und zeitnah ein funktionierendes Update geliefert.
10 February 2025 12:29
Support wird hier noch großgeschrieben
Danke für die Schnelle Hilfe, da können sich andere Firmen mal ne Scheibe von Abscheiden :-)
22 May 2023 12:25
Top!!!
Diese Erweiterung ist Spitzenklasse für PDF-Downloads.
Super einfach und genial zu bedienen.
17 May 2023 11:53
Optimal zur Ergänzung von Downloads zu einem Produkt
Für uns war wichtig, dass die Dokumenet auch via API gepflegt werden können. Das klappt mit dieser Erweiterung sehr gut.
Feedback und Wünsche nimmt Acris immer gerne an und setzt diese oft und schnell um. So macht eine Zusammenarbeit wirklich Spaß!
4 May 2023 11:54
Tut was es soll. Sehr guter Support
Tut genau was es soll und lässt sich auch in eigene Templates einbinden. Auch schneller Support bei Problemen.
18 July 2022 06:54
Super Plugin und Top Support!
Danke für die Erweiterung mit Links! Sehr gutes Plugin und Support.
30 June 2021 17:16
Super!
Macht was es soll und ist für uns eine sinnvolle Ergänzung.
11 March 2021 10:43
Einfache Bedienbarkeit und ein klasse Support!
Das Plugin funktioniert super, genau so wie es beschrieben wird.
Auch die Bedienung der Plugins ist kinderleicht.
Der Support müsste eigentlich mehr Sterne erhalten. Sehr sehr schnelle Antworten und das Problem wurde innerhalb eines Tages gelöst.
Example for JSON-call via Sync-API: POST http://www.mein-shop.de/api/_action/sync
[
{
"action": "upsert",
"entity": "product",
"payload": [
{
"id": "b851fd3085054856b83e1e693b5bbd1b",
...
"acrisDownloads": [
{
"fileName": "ACRIS_12345_1_DE.pdf",
"title": "Benutzerhandbuch",
"position": 0,
"languages": [
{
"id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b"
}
]
},
{
"fileName": "ACRIS_12345_1_EN.pdf",
"title": "Manual",
"position": 0,
"languages": [
{
"id": "01896943f9847021b988cede9f40d445"
}
]
}
]
}
]
}
]
Example for the API pattern of how should be links imported to the product via Sync-API.
[
{
"action": "upsert",
"entity": "product",
"payload": [
{
"id": "b851fd3085054856b83e1e693b5bbd1b",
"acrisLinks": [
{
"url": "https://www.acris-ecommerce.at/",
"linkTarget": true,
"title": "Title for Link",
"description": "Description for Link",
"position": 1,
"languages": [
{
"id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b"
}
]
}
]
}
]
}
]
If the downloads have already been uploaded to the media in the Shopware Admin, then I can assign the downloads via API as follows:
{
"id": "f947b036a41c4be38cdad7fddf13bd1d",
"acrisDownloads": [
{
"mediaId": "11d0ac3beb2e4f738f72732739e108b0",
"title": "Test file",
"position": 0,
"languages": [
{
"id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b"
},
{
"id": "7a6b724e70614488bc10740313df0409"
}
]
}
]
}
Example of a JSON call for the Sync API (UUID of the product, language and download entry must be known): POST http://www.my-shop.com/api/_action/sync
[
{
"key": "write",
"action": "upsert",
"entity": "product",
"payload": [
{
"id": "0189f245a8047d0e928c3d3a702eeedc",
"acrisDownloads": [
{
"id": "0189f2466f197d7b808601c970f8d034",
"title": "Download Title EN (default language)",
"description": "Download Description EN (default language)",
"translations": [
{
"languageId": "2fbb5fe2e29a4d70aa5854ce7ce3e20b",
"title": "Download Title EN (default language)",
"description": "Download Description EN (default language)"
},
{
"languageId": "0189d01b707a7298885830df99fcd93f",
"title": "Download Titel DE",
"description": "Download Description DE"
}
]
}
]
}
]
}
]
Example of a JSON call for the Sync API (UUID of the download entry must be known): POST http://www.my-shop.com/api/_action/sync
[
{
"action": "delete",
"payload": [
{
"id": "0189f2466f197d7b808601c970f8d034"
}
],
"entity": "acris_product_download"
}
]
Attention: The medium itself is not deleted with this call. It must be deleted via an additional call with the known UUID of the medium:
DELETE http://www.mein-shop.de/api/media/0189f2466ded7927a13d3904b7d1a0a2
Yes, a download can be assigned to a download group. This download group in turn can only be made accessible to certain customer groups via a stored rule. Other rules and conditions are also possible here.
The API documentation is available at: https://api-docs.acris.at/#ab6cf374-b77f-4cad-8e67-00f7c6f20636
