Version 3.1.1 Shopware 5.5 to 5.7 As of July 5, 2021
Do you offer software for download and have more than one version per item? Do you want to use several servers for downloads or deliver files from another domain? With this plugin you store any number of download links with their own names for each item and each variant.
Older versions of the plugin are available for Shopware 5.0 to 5.4. This guide describes version 3.1.1.
What the plugin does #
Each download has a link and a freely selectable name that appears as the link text. Downloads can be defined and sorted per language shop or subshop. Your customers see them on the order completion page, in the customer account and optionally in the order confirmation or a status email.
From version 3.1.0 on you can protect the downloads so that only logged-in buyers can access them. Without protection the downloads are direct links. In that case use file names that cannot be guessed.
Installation and setup #
- Install the plugin in the Plugin Manager. It is still deactivated after that.
- In the configuration, define whether the downloads should appear on the order completion page. There you also select the protection.
- Activate the plugin.
- Clear the cache under Configuration > Caches / performance > Cache > Select all > Clear.
- Log out of the backend once and log in again.
- Under Items > ESD Multi Download you now maintain the downloads of your items and variants.
Settings #
| Setting | Default | Effect |
|---|---|---|
| Show Downloads at Checkout | off | Shows the downloads on the order completion page. |
| Ignore Shopware settings | on | Ignores Shopware's ESD basic setting that releases downloads only at a certain payment status. |
| Download protection | None | None, Redirect or Proxy, see Download protection. |
| Proxy Settings | empty | cURL options for Proxy mode, one per line. |
Download protection #
None #
The link is output directly. Shopware checks nothing. Use this only if the server with the files protects against unauthorized access itself.
Redirect #
Shopware checks whether the customer is logged in and has bought the item that the download belongs to. It then redirects the customer to the address of the file, so the customer learns that address. This is also meant for external servers that protect the files themselves.
Proxy #
The downloads on the order completion page, in the customer account and in the emails run through your shop. Before that, Shopware checks whether the customer is logged in and has bought the item. The real address of the file stays hidden. Very large files can cause problems.
If you protect your files with password protection via .htaccess, enter the user name and password under "Proxy Settings":
CURLOPT_USERPWD => benutzername:passwort
CURLOPT_HTTPAUTH => CURLAUTH_BASICDownloads in the order confirmation #
You can send the download links with the order confirmation. Note: the links are then sent immediately when the order is placed, regardless of the order status and payment status.
Open the template under Configuration > E-mail management > E-mail templates > System e-mails > sORDER, in older versions under Configuration > E-mail templates. Each template exists as plain text and as HTML text. Insert the code at least in the "HTML text" tab. The headings in the code are in German. Adjust them to the language of your shop.
Without serial numbers:
{if $sEsd} <br/> <strong>Die Downloadlinks zu ihren bestellten Produkten:</strong><br/> <table width="80%" border="0" > <tr> <td bgcolor="#F7F7F2" ><strong>Artikel</strong></td> <td bgcolor="#F7F7F2" ><strong>Artikelnummer</strong></td> <td bgcolor="#F7F7F2" ><strong>Download Links</strong></td> </tr> {foreach item=product key=position from=$sEsd} <tr> <td >{$product.article_name}</td> <td >{$product.article_ordernumber}</td> <td > {foreach item=download key=position2 from=$product.downloads} <br/><a href="{$download.download_link}">{$download.download_name}</a><br/> {/foreach}<br/> </td> </tr> {/foreach} </table> <br/> <br/> {/if}With download links and serial numbers:
{if $sEsd} <br/> <strong>Die Downloadlinks zu ihren bestellten Produkten:</strong><br/> <table width="80%" border="0" style="font-family:Arial, Helvetica, sans-serif; font-size:10px;"> <tr> <td bgcolor="#F7F7F2" style="border-bottom:1px solid #cccccc;"><strong>Artikel</strong></td> <td bgcolor="#F7F7F2" style="border-bottom:1px solid #cccccc;"><strong>Artikelnummer</strong></td> <td bgcolor="#F7F7F2" style="border-bottom:1px solid #cccccc;"><strong>Download Links</strong></td> <td bgcolor="#F7F7F2" style="border-bottom:1px solid #cccccc;"><strong>Seriennummern</strong></td> </tr> {foreach item=product key=position from=$sEsd} <tr> <td style="border-bottom:1px solid #cccccc;">{$product.article_name}</td> <td style="border-bottom:1px solid #cccccc;">{$product.article_ordernumber}</td> <td style="border-bottom:1px solid #cccccc;"> {foreach item=download key=position2 from=$product.downloads} <br/><a href="{$download.download_link}">{$download.download_name}</a><br/> {/foreach}<br/> </td> <td style="border-bottom:1px solid #cccccc;"> {foreach item=serial key=position3 from=$product.serials} <br/>{$serial}<br/> {/foreach}<br/> </td> </tr> {/foreach} </table> <br/> <br/> {/if}Downloads in a status email #
Since version 3.0.4 the downloads are also available in the emails for the order status or payment status. This way you can, for example, send the links only once the payment has been received. Insert the code anywhere in the template of the status, at least in the "HTML text" tab.
Without serial numbers:
{if $EventResult && $EventResult.enno_esd} <br/> <strong>Die Downloadlinks zu ihren bestellten Produkten:</strong><br/> <table width="80%" border="0" > <tr> <td bgcolor="#F7F7F2" ><strong>Artikel</strong></td> <td bgcolor="#F7F7F2" ><strong>Artikelnummer</strong></td> <td bgcolor="#F7F7F2" ><strong>Download Links</strong></td> </tr> {foreach item=product key=position from=$EventResult.enno_esd} <tr> <td >{$product.article_name}</td> <td >{$product.article_ordernumber}</td> <td > {foreach item=download key=position2 from=$product.downloads} <br/><a href="{$download.download_link}">{$download.download_name}</a><br/> {/foreach}<br/> </td> </tr> {/foreach} </table> <br/> <br/> {/if}With download links and serial numbers:
{if $EventResult && $EventResult.enno_esd} <br/> <strong>Die Downloadlinks zu ihren bestellten Produkten:</strong><br/> <table width="80%" border="0" style="font-family:Arial, Helvetica, sans-serif; font-size:10px;"> <tr> <td bgcolor="#F7F7F2" style="border-bottom:1px solid #CCCCCC;"><strong>Artikel</strong></td> <td bgcolor="#F7F7F2" style="border-bottom:1px solid #CCCCCC;"><strong>Artikelnummer</strong></td> <td bgcolor="#F7F7F2" style="border-bottom:1px solid #CCCCCC;"><strong>Download Links</strong></td> <td bgcolor="#F7F7F2" style="border-bottom:1px solid #CCCCCC;"><strong>Seriennummern</strong></td> </tr> {foreach item=product key=position from=$EventResult.enno_esd} <tr> <td style="border-bottom:1px solid #CCCCCC;">{$product.article_name}</td> <td style="border-bottom:1px solid #CCCCCC;">{$product.article_ordernumber}</td> <td style="border-bottom:1px solid #CCCCCC;"> {foreach item=download key=position2 from=$product.downloads} <br/><a href="{$download.download_link}">{$download.download_name}</a><br/> {/foreach}<br/> </td> <td style="border-bottom:1px solid #CCCCCC;"> {foreach item=serial key=position3 from=$product.serials} <br/>{$serial}<br/> {/foreach}<br/> </td> </tr> {/foreach} </table> <br/> <br/> {/if}Help #
If this guide does not answer your question, write to us via the contact form on enno.dev.
