Zum Inhalt springen

enno.dev Commerce Partner

  • Startseite
  • Shopware 5
  • Shopware 6
  • Deutsch
    • Deutsch
    • English

Shopware 5

10
  • Awin Conversion Tracking, Remarketing und Server-to-Server-Tracking
  • Eigenschaften UND-Verknüpfung in den Filtern
  • Einlösbare Gutscheine je Kunde auch bei Gastbestellungen beschränken
  • ESD Multi-Download
  • Globale Preisänderungen
  • Registrierungsfilter gegen Spam-Anmeldungen
  • Suchbegriffe von der Suche ausschließen oder umleiten
  • Tabs Advanced: Alle Tabs zentral verwalten
  • Vorausgewählte Filter
  • Warenkorb leeren per Button

Shopware 6

11
  • Debug für Produktivsysteme
  • Digitale Produkte und Downloads (ESD)
  • Import mit Artikelnummern: Produkte über die Produktnummer aktualisieren
  • Produktlink statt Warenkorb Button
  • Registrierungsfilter gegen Spam-Anmeldungen
  • Sentinel Admin Security: 2FA, Login-Sperre, Dateityp-Prüfung
  • Tabs Advanced: Alle Tabs zentral verwalten
  • Tabs Advanced Erweiterung: Anker Tabs mit Sprungmarken
  • Tabs Advanced Erweiterung: Objekt-Zusatzfelder als Links ausgeben
  • Tabs Advanced Erweiterung: Produkt-Detailseite Layout-Zuweisung
  • Warenkorb leeren per Button
Kategorien anzeigen
  • Shopware 6
  • Digitale Produkte und Downloads (ESD)

Digitale Produkte und Downloads (ESD)

Version 2.3.0 Shopware ab 6.7.14 Stand 2. November 2026

Mit diesem Plugin bieten Sie zu Ihren Produkten Dateien zum Herunterladen an. Öffentliche Downloads wie Datenblätter oder Hörproben stehen auf der Produktseite. Geschützte Downloads sieht Ihr Kunde erst nach dem Kauf: auf der Bestellabschlussseite, im Kundenkonto und auf Wunsch in der E-Mail.

Für Shopware 6.3 bis 6.6 gibt es ältere Versionen des Plugins. Diese Anleitung beschreibt Version 2.3.0, ältere Versionen weichen in einigen Punkten ab.

Im Shopware Store ansehen

Was das Plugin kann #

Die Downloads verwalten Sie zentral in Download-Sets. Ein Set enthält beliebig viele Downloads und lässt sich beliebig vielen Produkten zuordnen. Varianten erben die Sets und die Kennzeichnung als digital von ihrem Hauptprodukt.

Jeder Download ist ein Link. Die Datei kann auf Ihrem Server, in der Medienverwaltung von Shopware oder auf einem externen Server liegen. Im Plugin selbst laden Sie keine Dateien hoch.

Ein Set ist entweder öffentlich oder geschützt. Öffentliche Sets erscheinen auf der Produktseite unter der Beschreibung, jeder Besucher kann sie herunterladen. Geschützte Sets bekommt nur der Kunde, der das Produkt bestellt hat. Er sieht sie erst, wenn seine Bestellung den eingestellten Zahlstatus erreicht hat.

Liegt ein Produkt im Warenkorb, das Sie als digital gekennzeichnet haben, zeigt die Kasse die Checkbox von Shopware: Der Kunde bestätigt, dass er sofort Zugang möchte und sein Widerrufsrecht damit erlischt. Ohne diesen Haken schließt die Kasse die Bestellung nicht ab, der Zeitpunkt der Zustimmung wird an der Bestellung gespeichert. Für den Rule Builder gibt es die Bedingung "Enno Digitale Positionen" mit den Werten Keine, Gemischt und Alle. Damit sperren Sie zum Beispiel Versandarten, wenn nur digitale Produkte im Warenkorb liegen.

Installation und Einrichtung #

  1. Installieren Sie das Plugin unter Erweiterungen > Meine Erweiterungen und aktivieren Sie es.
  2. Öffnen Sie die Konfiguration des Plugins. Prüfen Sie unter "Benötigter Zahlstatus", ab welchem Zahlstatus Ihre Kunden die geschützten Downloads erhalten. Eine neue Installation startet mit "Bezahlt". Die übrigen Einstellungen sind weiter unten erklärt.
  3. Legen Sie unter Katalog > Digitale Inhalte > Download Sets ein neues Set an. Geben Sie einen Namen ein, schalten Sie das Set aktiv und legen Sie fest, ob es öffentlich sein soll. Speichern Sie das Set.
  4. Fügen Sie im Set mit "Neuer Download" die einzelnen Dateien hinzu. Der Name ist der Linktext, den Ihr Kunde sieht. Der Link ist die Adresse der Datei. Die Position bestimmt die Reihenfolge.
  5. Ordnen Sie das Set den Produkten zu. Das geht im Set unter "Zugeordnete Produkte" oder im Produkt in der Karte "Digitales Produkt". Dort schalten Sie auch "Produkt ist digital" ein, wenn an der Kasse die Zustimmung abgefragt werden soll.
  6. Machen Sie eine Testbestellung. Prüfen Sie die Bestellabschlussseite, die Bestellung im Kundenkonto und die E-Mail.

Ordnen Sie einer Variante ein eigenes Set zu, zeigt diese Variante nur noch ihr eigenes Set. Varianten ohne eigenes Set erben weiter die Sets des Hauptprodukts. Eine Variante lässt sich auch dann als nicht digital einstellen, wenn ihr Hauptprodukt digital ist.

Die Download-Sets haben eine eigene Berechtigung "Digitale Inhalte" unter Einstellungen > Rollen, mit ansehen, bearbeiten, anlegen und löschen. Die Karte auf der Produktseite richtet sich nach den Berechtigungen für Produkte.

Shopware speichert Produktseiten im Cache. Eine Änderung an einem öffentlichen Set erscheint dort, sobald der Cache geleert oder abgelaufen ist.

Einstellungen #

Die Einstellungen finden Sie unter Erweiterungen > Meine Erweiterungen bei "Digitale Produkte" oder unter Katalog > Digitale Inhalte > Einstellungen. Sie gelten je Verkaufskanal.

EinstellungVorgabeWirkung
AktivanSchaltet das Plugin für den Verkaufskanal ein oder aus.
Kasse: Zustimmung zum sofortigen Zugang verlangen (Widerrufsrecht erlischt)anZeigt an der Kasse die Checkbox von Shopware, sobald ein Produkt mit "Produkt ist digital" im Warenkorb liegt. Der Zeitpunkt der Zustimmung steht an der Bestellung im Zusatzfeld "Digitale Produkte".
Absicherung nicht öffentlicher DownloadsProxyWie geschützte Downloads ausgeliefert werden: Proxy, Weiterleitung oder Keine. Siehe Absicherung der Downloads.
Maximale Downloadanzahl-1Wie oft ein Download je Bestellposition genutzt werden kann. -1 heißt unbegrenzt, 0 sperrt alle geschützten Downloads. Gilt nicht im Modus Keine.
Proxy EinstellungenleerZusätzliche cURL-Optionen für den Modus Proxy, eine pro Zeile, zum Beispiel CURLOPT_CONNECTTIMEOUT => 30. Erlaubt sind nur Optionen für Zeitlimits, Zertifikatsprüfung, Zugangsdaten und einen ausgehenden Proxy, siehe Proxy.
Benötigter ZahlstatusBezahltBei welchem Zahlstatus der Kunde geschützte Downloads sieht und herunterladen kann. Ist keiner gewählt, gibt es keine geschützten Downloads.
Downloads im Account anzeigen (In der Bestellübersicht)anZeigt geschützte Downloads im Kundenkonto bei der Bestellung.
Auch öffentliche Downloads im Account anzeigen (In der Bestellübersicht)ausZeigt dort zusätzlich die öffentlichen Downloads.
Account: Artikelname über den Downloads anzeigenanÜberschrift mit dem Produktnamen im Kundenkonto.
Account: Name des Sets über den Downloads anzeigenanÜberschrift mit dem Namen des Sets im Kundenkonto.
Downloads nach Bestellabschluss anzeigenanZeigt geschützte Downloads auf der Bestellabschlussseite, sofern der Zahlstatus schon erreicht ist.
Auch öffentliche Downloads nach Bestellabschluss anzeigenausZeigt dort zusätzlich die öffentlichen Downloads.
Bestellabschluss: Artikelname über den Downloads anzeigenanÜberschrift mit dem Produktnamen auf der Bestellabschlussseite.
Bestellabschluss: Name des Sets über den Downloads anzeigenanÜberschrift mit dem Namen des Sets auf der Bestellabschlussseite.
Produktseite: Öffentliche Download Sets anzeigenanZeigt öffentliche Sets auf der Produktseite unter der Beschreibung.

Absicherung der Downloads #

Die Absicherung betrifft nur geschützte Sets. Öffentliche Sets gibt das Plugin immer direkt als Link aus.

Proxy (Vorgabe) #

Der Kunde lädt die Datei über Ihren Shop herunter. Shopware prüft vorher, ob er angemeldet ist und die Bestellung aufgegeben hat, ob der Download zum bestellten Produkt gehört, ob er im Verkaufskanal der Bestellung abgerufen wird und ob der Zahlstatus passt. Die echte Adresse der Datei bleibt verborgen.

Der Proxy ruft nur Adressen mit http oder https ab. Liefert die Quelle nicht, weil sie einen Fehler meldet, nicht erreichbar ist oder eine Minute lang nichts sendet, erhält der Kunde einen Hinweis statt einer leeren Datei. Solche Downloads zählen nicht zur maximalen Downloadanzahl, ebenso wenig ein abgebrochener Download oder eine Linkvorschau.

Voreingestellt sind 30 Sekunden Zeitlimit für den Verbindungsaufbau und höchstens 10 Weiterleitungen. Eine Quelle, die eine Minute lang nichts sendet, bricht der Proxy ab. Unter "Proxy Einstellungen" können Sie diese Werte ändern und Zugangsdaten, Zertifikatsprüfung oder einen ausgehenden Proxy einstellen. Andere Optionen ignoriert das Plugin. CURLOPT_TIMEOUT begrenzt den ganzen Download und bricht große Dateien ab, für eine stockende Quelle ist CURLOPT_LOW_SPEED_TIME die bessere Wahl.

Liegen die Dateien hinter einem Passwortschutz per .htaccess, tragen Sie unter "Proxy Einstellungen" Benutzername und Passwort ein:

CURLOPT_USERPWD => benutzername:passwort
CURLOPT_HTTPAUTH => CURLAUTH_BASIC

Weiterleitung #

Shopware prüft wie beim Proxy die Berechtigung des Kunden. Danach leitet es ihn auf die Adresse der Datei weiter, die er damit erfährt. Das passt zu externen Download-Servern, die selbst vor unbefugtem Zugriff schützen.

Keine #

Der Link wird direkt ausgegeben, Shopware prüft nichts und die maximale Downloadanzahl gilt nicht. Nutzen Sie diesen Modus nur, wenn der Server mit den Dateien selbst prüft, wer herunterladen darf.

Wo die Dateien liegen sollten #

  • Am besten in einem eigenen Ordner auf Ihrem Server, geschützt per .htaccess, zusammen mit dem Modus Proxy.
  • In der Medienverwaltung von Shopware. Dort sind nur bestimmte Dateiendungen erlaubt. Die Dateien sind nicht zusätzlich geschützt: Wer den Link kennt, kann sie herunterladen. Öffnen Sie einen kopierten Link einmal im Browser und übernehmen Sie die Adresse aus der Adresszeile, Shopware gibt nicht immer eine gültige Adresse aus.
  • Auf einem externen Server oder in einem Cloud-Speicher. Die Einrichtung dort übernimmt, wer den Server betreut. Die meisten Cloud-Speicher können Dateien nicht zusätzlich schützen.

Die Proxy-Einstellungen gelten für alle Downloads. Liegen Dateien auf mehreren Servern, müssen alle mit denselben Einstellungen erreichbar sein.

Downloads in E-Mails #

Jede E-Mail-Vorlage, in der die Variable order.lineItems vorkommt, kann die Downloads ausgeben. Am besten eignet sich die Vorlage "Zahlungsstatus: bezahlt", denn geschützte Links funktionieren erst, wenn die Bestellung einen der eingestellten Zahlstatus hat. Fügen Sie diesen Code unter Einstellungen > E-Mail-Vorlagen dort ein, wo die Downloads erscheinen sollen:

{% 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 %}

Die Links entstehen auf der Domain des Verkaufskanals, wie die Links von Shopware selbst. Das ist wichtig, weil solche E-Mails oft aus der Administration oder von einem Hintergrundprozess verschickt werden.

Öffnet ein Kunde den Link ohne Anmeldung, führt er ihn zum Login und von dort direkt zur Datei. Gäste kommen auf ihre Bestellseite und schalten sie mit E-Mail-Adresse und Postleitzahl frei. Das geht, solange Shopware den Bestelllink eines Gasts gelten lässt, ohne andere Einstellung 30 Tage nach der letzten Änderung der Bestellung.

Vorlagen mit dem Code älterer Versionen (mit url(...) und |raw) funktionieren weiter. Ihre Links entstehen aber auf der Adresse dessen, der die E-Mail verschickt, bei einem Versand aus der Administration also nicht auf der Adresse des Shops. Ersetzen Sie deshalb url('frontend.enno.download', {...}) durch rawUrl('frontend.enno.download', {...}, salesChannel.domains|first.url) wie oben.

Den Zeitpunkt der Zustimmung zum sofortigen Zugang können Sie in der Bestellbestätigung mit order.customFields.enno_digital_products_revocation_consent ausgeben.

Häufige Fragen #

Die öffentlichen Downloads erscheinen nicht auf der Produktseite

Prüfen Sie, ob das Set aktiv und öffentlich ist und ob in der Konfiguration "Produktseite: Öffentliche Download Sets anzeigen" eingeschaltet ist. Shopware speichert Produktseiten im Cache, eine Änderung erscheint erst nach dem Leeren des Caches.

Die Downloads stehen im Bereich der Produktbeschreibung. Fehlt dieser Bereich in einem eigenen Layout der Produktseite, fehlen auch die Downloads.

Der Kunde bekommt statt der Datei einen Hinweis

Im Modus Proxy holt der Shop die Datei von der hinterlegten Adresse. Klappt das nicht, sieht der Kunde einen Hinweis. Prüfen Sie:

  • Öffnen Sie den Link der Datei im Browser. Lädt die Datei dort und bleibt die Adresse gleich, stimmt der Link.
  • Der Proxy ruft nur Adressen mit http oder https ab.
  • Liegt die Datei hinter einem Passwortschutz, tragen Sie die Zugangsdaten unter "Proxy Einstellungen" ein.
  • Klappt es mit CURLOPT_SSL_VERIFYPEER => false, stimmt etwas mit dem SSL-Zertifikat des Download-Servers nicht. Lassen Sie es von dessen Betreuer prüfen und nehmen Sie die Zeile danach wieder heraus.
Wie oft kann ein Kunde eine Datei herunterladen?

So oft, wie unter "Maximale Downloadanzahl" eingestellt ist, gezählt je Download und Bestellposition. Die Vorgabe -1 heißt unbegrenzt. Fehlgeschlagene oder abgebrochene Downloads und Linkvorschauen zählen nicht mit. Downloads, die vor dem Update auf 2.3.0 protokolliert wurden, zählen dagegen mit.

Ändert das Plugin den Bestell-, Versand- oder Zahlstatus?

Nein. Den Zahlstatus, ab dem Downloads ausgeliefert werden, legen Sie in der Konfiguration fest. Soll sich ein Status automatisch ändern, geht das teilweise mit dem Flow Builder von Shopware.

Gilt die Zustimmung an der Kasse auch für Bestellungen über die Store API?

Nein. Wie die Prüfung von Shopware selbst gilt sie für die Kasse im Storefront. Ein Frontend oder eine App, die über die Store API bestellt, muss die Zustimmung selbst einholen.

Hinweise zum Update #

Update auf 2.3.0 #

  • "Benötigter Zahlstatus" steuert jetzt auch die Auslieferung geschützter Downloads, nicht nur deren Anzeige.
  • Die Zustimmung an der Kasse ist jetzt die Checkbox von Shopware. Statt des Textbausteins ennoDigitalProducts.checkout.esdAccept gilt checkout.confirmRevocationTerms.
  • In E-Mail-Vorlagen sollten Sie url(...) durch rawUrl(...) ersetzen, siehe Downloads in E-Mails.
  • Downloads, die vor dem Update protokolliert wurden, zählen zur maximalen Downloadanzahl.
  • Für die Download-Sets gibt es die Berechtigung "Digitale Inhalte" unter Einstellungen > Rollen.
  • Für Entwickler: Die Konstruktoren von EnnoDownloadController und DigitalProductDataService haben sich geändert.

Update auf 2.0.0 #

Tragen Sie nach dem Update in der Konfiguration den benötigten Zahlstatus neu ein.

Alle Änderungen je Version stehen im Changelog auf der Seite des Plugins im Shopware Store.

Hilfe #

Hilft Ihnen diese Anleitung nicht weiter, schreiben Sie uns über das Kontaktformular auf enno.dev.

Inhalt
  • Was das Plugin kann
  • Installation und Einrichtung
  • Einstellungen
  • Absicherung der Downloads
    • Proxy (Vorgabe)
    • Weiterleitung
    • Keine
    • Wo die Dateien liegen sollten
  • Downloads in E-Mails
  • Häufige Fragen
  • Hinweise zum Update
    • Update auf 2.3.0
    • Update auf 2.0.0
  • Hilfe

enno.dev Commerce Partner

Shopware-Plugins
  • Shopware 6
  • Shopware 5
  • Alle Plugins im Shopware Store
Kontakt
  • Kontaktformular
  • enno.dev
  • Commerce Partner
Rechtliches
  • Impressum
  • Datenschutz