Download Center

Install the app as usual via the extension management in Shopware.
After the installation, you will find the "Download Center" module in the "Content" tab. There you can configure the Download Center.

To add a new album, please switch to the system default language first. Please note that you have to edit an album to store the connection data. To be able to maintain the files then, please synchronize the files.
Please note that you must edit an album after adding it to store the connection data. To be able to maintain the files, please synchronize the files.

Note: If you are using SFTP (FTP via SSH), problems may occur when downloading larger files. For larger files we recommend the use of an FTP connection. If you would like more external sources for our app, please contact us at shopware@blackpoint.de.

Use Cases (Display in the frontend)

The Download Center provides a central location where your customers can download data. Accordingly, the Download Center is normally displayed on a single page, which can be accessed via the account menu. You can use the settings in the backend to configure that the link to the Download Center should also be displayed in the top bar. 

Alternatively, you can use an experience world element to display certain albums on certain pages/layouts. 

This also makes it possible to set up downloads for individual products manually. However, as there is usually no direct link between the article and album and this is created indirectly, it is only suitable for a few products (about 10-20 products maximum). Below you will find instructions on how it works:

1) Create album

a. Go to the configuration of the Download Center in "Content" > "Download Center".

b. Create a new album for your product and synchronize the files

2) Create layout

a. Go to "Content" > "Shopping Experiences" and create a new layout for your product, e.g. as a copy of the default product page layout.

b. Customize the layout. Select the block category "Download Center" on the right and add the CMS block "Download Center Album" to the desired place.

c. In the settings for the block (gear icon) select the corresponding album and save the layout

3) Assign layout and test result

a. Find your product under "Catalogs" -> "Products" and click on the product name to switch to the detail/edit view

b. Under the "Layout" and "Assign Layout" tab, assign the layout you've just created.

c. Clear the cache under "Settings" > "System" tab > "Caches & Indexes" > "Clear Caches".

d. Switch to the storefront and reload the page. You should now see the downloads for your product.

Access restrictions

If you want to restrict the access of the album to certain users, you can create a new rule using the "Availability Rule" option in the album configuration. The Shopware Rule Builder is used for this and therefore offers a high degree of flexibility in availability control.

Setup Cronjob / Automatic synchronization of albums

For the automatic synchronization of the albums a CLI command is available. This can be called via the following command: "bin/console bpa:downloadcenter:synchronize-albums".

Please contact your server provider for more information on setting up server-side cronjobs.

Meta files

You can enable the use of meta files in the app settings. This allows you to maintain the title and description of files without backend access. In combination with a cronjob, this allows you to synchronize albums automatically.

The meta files have to be created as .txt-files and have to be named exactly like the original file incl. file extension, at the end the file extension .txt has to follow.

Example:
Original file: bbb_sunflower_2160p_60fps_normal.mp4
meta file: bbb_sunflower_2160p_60fps_normal.mp4.txt

The first line of the .txt-Meta file is used as the title for the file, all following lines are used for the description. HTML can also be used for the description.

Example: Content of file bbb_sunflower_2160p_60fps_normal.mp4.txt

Please note that the meta files do not support localization of the texts.

Do you have any questions about installing or using the app or would you like to make a request for the next version? Via shopware@blackpoint.de you can reach the right contact person directly. We are looking forward to your feedback!