Product Downloads and Product Links

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

Manual (PDF)