Installationsanleitung

Basis Integration #

Die App kann schnell und einfach über das Backend installiert werden.  

Bitte prüfen Sie danach die App Konfiguration, damit alles wie gewünscht funktioniert. 

Absicherungseinstellungen #

Für Downloads gibt es in der App Konfiguration Absicherungseinstellungen. Diese betreffen lediglich nicht Öffentliche Download Sets und funktionieren folgendermaßen: 
– Proxy: Dies ist die Standard Einstellung. Die nicht Öffentlichen Downloads werden auf der Bestellbestätigungsseite und im Account über einen Controller heruntergeladen. Hierbei wird kontrolliert ob der Nutzer ein eingeloggter Kunde ist und ob er einen Artikel gekauft hat zu dem das Downloadset gehört und die echten Links der Downloads sind somit nicht nach außen sichtbar.
Falls sie einen .htaccess Passwortschutz verwenden um ihre Dateien zu schützen dann können sie im Feld „Proxy Einstellungen“ folgendes eintragen (username und password müssen entsprechend ersetzt werden):

CURLOPT_USERPWD =>username:password

CURLOPT_HTTPAUTH => CURLAUTH_BASIC– Keine: Bei dieser Einstellung wird der Link unverschlüsselt im Frontend ausgegeben. Diese Einstellung kann genutzt werden, falls ein externer Download Server verwendet wird und Shopware keine Kontrollen durchführen soll. (Wir empfehlen dies nur zu nutzen wenn der externe Server eigene Absicherungen vor unbefugten Zugriff hat)
– Weiterleitung: Bei dieser Einstellung wird auch kontrolliert ob der Nutzer ein eingeloggter Kunde ist und ob er einen Artikel gekauft hat zu dem das Downloadset gehört, aber danach wird auf den hinterlegten Link (sichtbar) weitergeleitet. Diese Einstellung ist ebenfalls für externe Server gedacht, wobei aber hier noch Shopware vorher Berechtigungen prüft. (Auch hier empfehlen wir dies nur zu nutzen wenn der externe Server eigene Absicherungen vor unbefugten Zugriff hat)

Anlegen eines Downloads #

Nach der Installation gibt es im Admin Menü unter dem Punkt „Katalog“ den neuen Menüpunkt „Downloads“.

Dort muss zunächst ein DownloadSet angelegt und gespeichert werden. Hier ist zu beachten die Einstellung „Öffentlich“, da Sets die als Öffentlich markiert sind nicht von Absicherungseinstellungen betroffen sind und die Downloadlinks im Frontend direkt ausgegeben werden.
Danach können in diesem DownloadSet einzelne Downloads hinterlegt werden.

Das DownloadSet muss nun noch den gewünschten Artikeln zugewiesen werden. Dies kann entweder direkt im DownloadSet oder alternativ auch im Produkt gemacht werden. 

Downloadsets werden automatisch an die Varianten vererbt, dies kann falls nicht gewünscht in den Varianten aufgehoben werden.

Einbau in ein Mailtemplate #

In Mailtemplates können ebenfalls die Downloads ausgegeben werden. Voraussetzung hierfür ist, dass die Variable order.lineItems dem Mail Template existiert.

Sie können folgendes Beispiel Snippet zur Ausgabe nutzen:

{% 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 %}{{ url('frontend.enno.download', {'did': ennoDownload.id, 'oid': order.id, 'lid': lineItem.id }) }}{% endif %}" target="_blank" rel="noopener nofollow">{{ ennoDownload.translated.name|raw }}</a><br>
        {% endfor %}
        <br>
      {% endfor %}
    {% endif %}
  {% endfor %}
{% endif %}

Für eine Kontrolle des Zahlungsstatus, schauen sie bitte in unsere FAQs.

Ab Version 1.2.3 Kompatibilität mit „One Page Checkout“ von PremSoft #

Falls sie unser Plugin mit dem „One Page Checkout“ zusammen verwenden möchten ist die Installationsreihenfolge wichtig. Unser Plugin muss als erstes installiert werden und danach das „One Page Checkout“ Plugin, da ansonsten die Widerrufsbelehrung zu den Digitalen Produkten nicht angezeigt werden kann.

Powered by BetterDocs