Version 2.3.0 Shopware from 6.7.14 As of November 2, 2026
With this plugin you offer files for download with your products. Public downloads such as data sheets or audio samples appear on the product page. Your customer sees protected downloads only after the purchase: on the order completion page, in the customer account and optionally in the email.
Older versions of the plugin are available for Shopware 6.3 to 6.6. This guide describes version 2.3.0. Older versions differ in some details.
What the plugin does #
You manage the downloads centrally in download sets. A set holds any number of downloads and can be assigned to any number of products. Variants inherit the sets and the digital flag from their parent product.
Each download is a link. The file can be on your server, in Shopware's media management or on an external server. You do not upload any files in the plugin itself.
A set is either public or protected. Public sets appear on the product page below the description. Every visitor can download them. Only the customer who ordered the product gets protected sets. The customer sees them once the order has reached the configured payment status.
If the cart contains a product that you have marked as digital, the checkout shows Shopware's checkbox: the customer confirms that they want immediate access and that their right of withdrawal expires as a result. Without this checkmark the checkout does not complete the order. The time of consent is stored on the order. For the Rule Builder there is the condition "Enno digital line items" with the values None, Mixed and All. You can use it, for example, to block shipping methods when the cart contains only digital products.
Installation and setup #
- Install the plugin under Extensions > My extensions and activate it.
- Open the plugin configuration. Under "Necessary payment state", check at which payment status your customers receive the protected downloads. A new installation starts with "Paid". The other settings are explained below.
- Under Catalogues > Digital contents > Download Sets, create a new set. Enter a name, set it to active and decide whether it should be public. Save the set.
- In the set, add the individual files with "New Download". The name is the link text your customer sees. The link is the address of the file. The position determines the order.
- Assign the set to the products. You can do this in the set under "Assigned products" or in the product in the "Digital product" card. There you also switch on "Product is digital" if the checkout should ask for consent.
- Place a test order. Check the order completion page, the order in the customer account and the email.
If you assign a separate set to a variant, this variant shows only its own set. Variants without their own set keep inheriting the sets of the parent product. You can also set a variant to not digital when its parent product is digital.
The download sets have their own permission "Digital contents" under Settings > Roles, with view, edit, create and delete. The card on the product page follows the permissions for products.
Shopware caches product pages. A change to a public set appears there once the cache has been cleared or has expired.
Settings #
You find the settings under Extensions > My extensions at "Digital Products" or under Catalogues > Digital contents > Settings. They apply per sales channel.
| Setting | Default | Effect |
|---|---|---|
| Active | on | Switches the plugin on or off for the sales channel. |
| Checkout: require the consent to immediate access (right of withdrawal expires) | on | Shows Shopware's checkbox at checkout as soon as a product with "Product is digital" is in the cart. The time of consent is shown on the order in the custom field "Digital products". |
| Protection of non-public downloads | Proxy | How protected downloads are delivered: Proxy, Redirect or None. See Download protection. |
| Maximum number of downloads | -1 | How often a download can be used per order line item. -1 means unlimited. 0 blocks all protected downloads. Does not apply in None mode. |
| Proxy Settings | empty | Additional cURL options for Proxy mode, one per line, for example CURLOPT_CONNECTTIMEOUT => 30. Only options for timeouts, certificate checks, credentials and an outgoing proxy are allowed, see Proxy. |
| Necessary payment state | Paid | The payment status at which the customer sees and can download protected downloads. If none is selected, there are no protected downloads. |
| Show downloads in account (in the order overview) | on | Shows protected downloads with the order in the customer account. |
| Also show public downloads in account (in the order overview) | off | Also shows the public downloads there. |
| Account: Show article name above the downloads | on | Heading with the product name in the customer account. |
| Account: Show name of the set above the downloads | on | Heading with the name of the set in the customer account. |
| Show downloads after order completion | on | Shows protected downloads on the order completion page if the payment status has already been reached. |
| Also show public downloads after order completion | off | Also shows the public downloads there. |
| Order completion: Show article name above the downloads | on | Heading with the product name on the order completion page. |
| Order completion: Show name of the set above the downloads | on | Heading with the name of the set on the order completion page. |
| Product page: Show public download sets | on | Shows public sets on the product page below the description. |
Download protection #
Protection applies only to protected sets. The plugin always outputs public sets directly as a link.
Proxy (default) #
The customer downloads the file through your shop. Before that, Shopware checks whether the customer is logged in and placed the order, whether the download belongs to the ordered product, whether it is requested in the sales channel of the order and whether the payment status matches. The real address of the file stays hidden.
The proxy only fetches addresses with http or https. If the source does not deliver because it reports an error, cannot be reached or sends nothing for a minute, the customer gets a notice instead of an empty file. Such downloads do not count toward the maximum number of downloads. The same applies to a canceled download or a link preview.
The defaults are a 30-second timeout for establishing the connection and at most 10 redirects. The proxy aborts a source that sends nothing for a minute. Under "Proxy Settings" you can change these values and set credentials, certificate checks or an outgoing proxy. The plugin ignores other options. CURLOPT_TIMEOUT limits the whole download and cuts off large files. For a source that stalls, CURLOPT_LOW_SPEED_TIME is the better choice.
If the files are behind password protection via .htaccess, enter the user name and password under "Proxy Settings":
CURLOPT_USERPWD => benutzername:passwort
CURLOPT_HTTPAUTH => CURLAUTH_BASICRedirect #
As with the proxy, Shopware checks the customer's authorization. It then redirects the customer to the address of the file, so the customer learns that address. This suits external download servers that protect against unauthorized access themselves.
None #
The link is output directly. Shopware checks nothing and the maximum number of downloads does not apply. Use this mode only if the server with the files checks by itself who may download them.
Where to store the files #
- Preferably in a separate folder on your server, protected via .htaccess, combined with Proxy mode.
- In Shopware's media management. Only certain file extensions are allowed there. The files are not additionally protected: anyone who knows the link can download them. Open a copied link once in the browser and take the address from the address bar, because Shopware does not always output a valid address.
- On an external server or in cloud storage. The setup there is done by whoever manages the server. Most cloud storage services cannot protect files additionally.
The proxy settings apply to all downloads. If files are on several servers, all of them must be reachable with the same settings.
Downloads in emails #
Every email template that contains the variable order.lineItems can output the downloads. The template "Payment status: paid" is best suited, because protected links only work once the order has one of the configured payment statuses. Insert this code under Settings > Email templates where the downloads should appear:
{% set EnnoDigitalProducts = config('EnnoDigitalProducts') %}
{% if EnnoDigitalProducts and EnnoDigitalProducts.config.active %}
{% for lineItem in order.lineItems %}
{% if lineItem.extensions is defined and lineItem.extensions.ennoDigitalProducts is defined and lineItem.extensions.ennoDigitalProducts.downloadSets is defined %}
{% for ennoDownloadSet in lineItem.extensions.ennoDigitalProducts.downloadSets %}
<b>{{ ennoDownloadSet.translated.name }}</b><br>
{% for ennoDownload in ennoDownloadSet.downloads %}
<a href="{% if EnnoDigitalProducts.config.downloadsProtectionMode == 'none' or ennoDownloadSet.public %}{{ ennoDownload.translated.link }}{% else %}{{ rawUrl('frontend.enno.download', {'did': ennoDownload.id, 'oid': order.id, 'lid': lineItem.id }, salesChannel.domains|first.url) }}{% endif %}" target="_blank" rel="noopener nofollow">{{ ennoDownload.translated.name|sw_sanitize }}</a><br>
{% endfor %}
<br>
{% endfor %}
{% endif %}
{% endfor %}
{% endif %}The links are built on the domain of the sales channel, like Shopware's own links. This matters because such emails are often sent from the Administration or by a background process.
If a customer opens the link without being logged in, it takes them to the login and from there directly to the file. Guests reach their order page and unlock it with their email address and postal code. This works as long as Shopware accepts a guest's order link, by default 30 days after the last change to the order.
Templates with the code of older versions (with url(...) and |raw) keep working. Their links, however, are built on the address of whatever sends the email. For an email sent from the Administration, that is not the address of the shop. Therefore replace url('frontend.enno.download', {...}) with rawUrl('frontend.enno.download', {...}, salesChannel.domains|first.url) as shown above.
You can output the time of consent to immediate access in the order confirmation with order.customFields.enno_digital_products_revocation_consent.
Frequently asked questions #
The public downloads do not appear on the product page
Check whether the set is active and public and whether "Product page: Show public download sets" is switched on in the configuration. Shopware caches product pages, so a change only appears after the cache has been cleared.
The downloads appear in the product description area. If a custom layout of the product page lacks this area, the downloads are missing as well.
The customer gets a notice instead of the file
In Proxy mode the shop fetches the file from the stored address. If that fails, the customer sees a notice. Check the following:
- Open the link of the file in the browser. If the file loads there and the address stays the same, the link is correct.
- The proxy only fetches addresses with http or https.
- If the file is behind password protection, enter the credentials under "Proxy Settings".
- If it works with
CURLOPT_SSL_VERIFYPEER => false, something is wrong with the SSL certificate of the download server. Have the person who manages that server check it and then remove the line again.
How often can a customer download a file?
As often as set under "Maximum number of downloads", counted per download and order line item. The default -1 means unlimited. Failed or canceled downloads and link previews do not count. Downloads logged before the update to 2.3.0 do count, however.
Does the plugin change the order, delivery or payment status?
No. You set the payment status at which downloads are delivered in the configuration. If you want a status to change automatically, Shopware's Flow Builder can do this in some cases.
Does the consent at checkout also apply to orders via the Store API?
No. Like Shopware's own check, it applies to the checkout in the Storefront. A frontend or app that places orders through the Store API must obtain the consent itself.
Update notes #
Update to 2.3.0 #
- "Necessary payment state" now also controls the delivery of protected downloads, not only their display.
- The consent at checkout is now Shopware's checkbox. Instead of the text snippet
ennoDigitalProducts.checkout.esdAccept, the snippetcheckout.confirmRevocationTermsapplies. - In email templates you should replace
url(...)withrawUrl(...), see Downloads in emails. - Downloads logged before the update count toward the maximum number of downloads.
- The download sets have the permission "Digital contents" under Settings > Roles.
- For developers: the constructors of
EnnoDownloadControllerandDigitalProductDataServicehave changed.
Update to 2.0.0 #
After the update, enter the necessary payment state again in the configuration.
All changes per version are listed in the changelog on the plugin's page in the Shopware Store.
Help #
If this guide does not answer your question, write to us via the contact form on enno.dev.
