Warum werden die öffentlichen Downloads nicht angezeigt? #

Schauen sie als erste ob das Downloadset auf öffentlich gestellt und die Anzeige auf der Detailseite in der Plugin Konfiguration aktiviert ist.
Wenn dies korrekt eingestellt ist prüfen sie bitte ob in den Produkten ein Layout hinterlegt ist (dies kann auch automatisch durch ein Shopware Update passieren) und entfernen sie die Zuweisung falls vorhanden. Unser Plugin unterstützt derzeit die Layout-Funktion leider nicht.
Sollte die Ausgabe dennoch nicht funktionieren kontaktieren sie uns bitte.

Die gedownloadete Datei lässt sich nicht öffnen / ist leer, woran liegt dies? #

Die Ursachen hierfür sind leider vielfältig und hängen oft mit Servereinstellungen zusammen. Die folgenden Dinge können sie ausprobieren:

1. Prüfen sie ob der Downloadlink eine konforme URL ist. Die Medienverwaltung von Shopware gibt zum Beispiel nicht unbedingt einen konformer Link im Admin Bereich heraus. Öffnen sie den Downloadlink einmal in ihrem Browser, prüfen sie ob die Datei korrekt gedownloadet wird und ob die URL noch identisch mit dem hinterlegten Link ist.
2. Falls sie die Sicherheitseinstellung Proxy nutzen, tragen sie folgendes in die Proxy-Einstellungen ein:
   CURLOPT_FOLLOWLOCATION => true
   Dies sorgt dafür, dass Weiterleitungen bis zum Ziel verfolgt werden und wird von manchen Servern benötigt um die Dateien auszuliefern.
3. Bei der Sicherheitseinstellung Proxy kann auch folgende Proxy-Einstellungen getestet werden:
   CURLOPT_SSL_VERIFYHOST => false
   CURLOPT_SSL_VERIFYPEER => false
   Sollte dies helfen, so gibt es bei den Download Dateien ein Problem mit dem SSL-Zertifikat. Wir empfehlen hier, dass die Zertifikate des Download Servers einmal von der dafür zuständigen Person / Firma geprüft werden.
4. Benennen sie die gedownloadete Datei in eine .txt Datei um und testen sie ob diese sich in einem Editor öffnen lässt. Je nach Ursache des Problems kann es sein, dass eine Fehlernachricht gedownloadet wurde, welche nun im Editor lesbar ist und einen Aufschluss gibt woran es liegt.

Es gibt für den Proxy eine Menge zusätzlicher Einstellungen die je nachdem angepasst werden müssen (siehe https://www.php.net/manual/de/function.curl-setopt.php). Wir empfehlen dies nur mit entsprechender Erfahrung selbst vorzunehmen.

Wo sollten nicht öffentliche Dateien am besten abgelegt werden? #

Unser Plugin benötigt lediglich einen aufrufbaren Link und ist ansonsten unabhängig davon wo die Dateien liegen.
Die meist genutzten Möglichkeiten sind:

1. Geschützter Ordern auf dem Server (unsere Empfehlung)
   Hierbei wird im Shopware public Verzeichnis mittels FTP ein Unterordner angelegt und in diesem die Dateien hinterlegt. Der Ordner sollte dann per .htaccess Schutz abgesichert werden (siehe Installationsanleitung)
2. Shopware Medien Verwaltung
   Die Dateien können auch in Shopware hochgeladen werden, allerdings gibt es hier ein paar Dinge zu beachten.
   Dateiendungen: Shopware erlaubt nur bestimmte Dateiendungen beim Hochladen. Diese Liste an erlaubten Typen kann jedoch durch ein zusätzliches Plugin bearbeitet werden.
   Downloadlink: Der Link kann in der Medienverwaltung nach dem Hochladen kopiert werden, jedoch gibt Shopware an dieser Stelle nicht unbedingt einen URL konformen Link heraus. Öffnen sie den erhaltenen Link vorsichtshalber im Browser und kopieren sie die von ihrem Browser konform gemachte URL.
   Absicherung: Bei dieser Vorgehensweise sind die Dateien nicht extra gegen unbefugten Zugriff abgesichert (jeder der den Shopware Medialink hat kann die Datei Downloaden)
3. Ein externer Server
   In diesem Fall ist der externe Server für die Downloads zuständig und die notwendigen Einstellungen sind von den für die Anbindung zuständigen Personen vorzunehmen.
4. Cloud System (z.B. Google Drive)
   Für die jeweiligen Systeme finden sich im Web Anleitungen für direkte Downloadlinks. Bei Cloud Systemen ist zu beachten, dass die Dateien aber meist nicht extra gegen unbefugten Zugriff absicherbar sind.

Können Downloaddateien von verschiedenen Servern ausgeliefert werden? #

Dies ist tendenziell möglich, allerdings lassen sich im Plugin nur einmal Proxy-Einstellungen hinterlegen, was bedeutet alle angebundenen Server müssen mit diesen Proxy-Einstellungen erreichbar sein. Unterschiedliche Absicherungseinstellungen (zum Beispiel Passwörter) sind somit nicht möglich.

Warum wird im Mail Template der Bestellbestätigung der Zahlungsstatus ignoriert? #

Wir empfehlen zum Versenden der Downloads grundsätzlich eine Zahlungstatus Mail zu verwenden, da hier die Kontrollstrukturen von Shopware vorhanden sind.
Falls in der Bestellbestätigungsmail der Zahlstatus kontrolliert werden soll, muss die Zeile

{% if EnnoDigitalProducts and EnnoDigitalProducts.config.active %}

ausgetauscht werden gegen

{% if EnnoDigitalProducts and EnnoDigitalProducts.config.active and order.transactions and order.transactions.0 and order.transactions.0.stateMachineState.technicalName and order.transactions.0.stateMachineState.technicalName in EnnoDigitalProducts.config.downloadsFrontendDisplayPaymentStates %}

(zuletzt geprüft in Shopware 6.4.6)

Werden Bestell-, Versand-, oder Zahlungstatus automatisch verändert? #

Das Plugin verändert keinen Status von selbst. Der notwendige Zahlungsstatus um auf Downloads zuzugreifen wird in der Plugin Konfiguration angegeben. Soll ein Status automatisch verändert werden, kann dies teilweise mit dem Flow Builder oder alternativ mit einem zusätzlichen Plugin integriert werden.