Upload-Modul mit gesichertem Link aufrufen

Das Upload-Modul kann mittels Link aufgerufen werden, in dem die Upload-ID bzw. Auftragsnummer mit einem Hash-Wert gesichert übergeben wird.

Der Aufruf des Upload-Moduls ist dann mit manueller Eingabe der Upload-ID bzw. Auftragsnummer nicht mehr möglich.

Diese Links können aus dem Shop heraus optional per E-Mail versandt werden.

Inhalt

Funktionsweise

Integration

Hinweise

 

Funktionsweise

Anstelle des manuellen Eingebens von Auftragsnummer bzw. Upload-ID benötigt der Nutzer den (verschlüsselten) Upload-Link, um seine Daten für das Upload-Produkt hochzuladen.

Upload-Links zum Hochladen von Dateien können auf folgenden Seiten angeboten werden:

HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm)

Bestelleingangsbestätigungs-E-Mail (mail_customer_order.htm)

Bestellhistorie (ws_order_history.htm)

in den Bestelldaten

Optional können diese Upload-Links vom Kunden auch komfortabel per E-Mail an Dritte weitergeleitet werden. Diese Versandfunktion per E-Mail kann auf der HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm) sowie auf der Kundenkontoübersichtsseite (ws_user_account.htm) angeboten, per Deep-Link aufgerufen und auch per AJAX eingebunden werden.

 

Integration

Die ersten 4 Schritte sind notwendig, um den Aufruf des Upload-Moduls mittels Link zu integrieren, in dem die Upload-ID bzw. Auftragsnummer verschlüsselt übergeben wird.

Wenn Sie auf die Versand-Funktion der Upload-Links per E-Mail wünschen, führen Sie bitte auch die nachfolgenden Schritte durch.

Schritt 1: Freischaltung/Aktivierung durch WEBSALE

Für die Nutzung ist eine technische Freischaltung/Aktivierung seitens WEBSALE notwendig. Bitte wenden Sie sich an Ihren WEBSALE-Ansprechpartner.

Schritt 2: Link konfigurieren

Konfigurieren Sie die Art des Links, der in die Bestellhistorie (bzw. die Bestelldaten) geschrieben werden soll. Ergänzen Sie hierfür folgenden Abschnitt/Parameter:

<Upload>
   OrderDataUploadLink-Type = UploadLink
</Upload>

Referenz: Abschnitt Upload

Schritt 3: Bestelleingangsbestätigungs-E-Mail (mail_customer_order.htm) erweitern

Ergänzen Sie in der Bestelleingangsbestätigungs-E-Mail (mail_customer_order.htm) einen der folgenden Links, je nach gewünschter Art des Deep-Links:

~WS-UploadLink~

Deep-Link auf das Upload-Modul mit gesicherter UploadID

~WS-OrderUploadLink~

Deep-Link auf das Upload-Modul mit gesicherter Auftragsnummer

Referenz: WS-UploadLink

Referenz: WS-OrderUploadLink

Schritt 4: Template des Upload-Moduls ws_upload.htm bearbeiten

Entfernen Sie Sie im Template des Upload-Moduls ws_upload.htm die Klammerung {UplIdInput}, diese wird nicht mehr benötigt.

Haben Sie alle Schritte durchgeführt, ist der Aufruf der Upload-Moduls mittels verschlüsseltem Link erfolgreich in Ihrem Shop integriert und aktiv.

Schritt 5: Template für Anzeige des Link-Versands definieren (optional)

Fügen Sie im Abschnitt <Templates> der Shopkonfiguration shop.config den Parameter UploadSendLink hinzu und geben Sie den Namen eines neuen Templates an:

<Templates>
  UploadSendLink =            ws_upload_send_link.htm
</Templates>

Referenz: Abschnitt Templates

Schritt 6: Anzeige des Link-Versands ergänzen (optional)

Legen Sie nun ein neues Template an und speichern Sie es unter dem Namen wie beim o. g. Parameter angegeben in Ihrem Template-Verzeichnis, z. B. benutzer/templates/translation.

Fügen Sie folgende Inhalte zur Anzeige des Link-Versands ein:

...
{ST-SendUploadLink_error(1)}Bitte kontrollieren Sie Ihre Eingaben{/ST-SendUploadLink_error(1)}
{ST-SendUploadLink_error(2)}E-Mail konnte nicht versendet werden{/ST-SendUploadLink_error(2)}
 
Upload-Link senden
{!ST-SendUploadLink_success}
    <form action="~FORM-SendUploadLink~" method="post">
       Auftragsnummer: <input type="text" name="~SENDUPLOADLINK-OrderNumber_name~" value="~SENDUPLOADLINK-OrderNumber~"> {SENDUPLOADLINK-OrderNumber_error}Fehler{/SENDUPLOADLINK-OrderNumber_error}
       E-Mail-Adresse des Empf&auml;ngers: <input type="text" name="~SENDUPLOADLINK-EmailTo_name~" value="~SENDUPLOADLINK-EmailTo~"> {SENDUPLOADLINK-EmailTo_error}Fehler{/SENDUPLOADLINK-EmailTo_error}
       <input type="submit" value="absenden" name="~BT-SendUploadLink~">
    </form>
{/!ST-SendUploadLink_success}
{ST-SendUploadLink_success}
   Upload-Link wurde erfolgreich versendet an: ~SENDUPLOADLINK-EmailTo~
{/ST-SendUploadLink_success}
 
<a href="~WS-UserAccountLink~" class="button_back">zurück zum Kundenkonto</a>
...

Referenz: ST-SendUploadLink_error

Referenz: ST-SendUploadLink_success

Referenz: FORM-SendUploadLink

Referenz: SENDUPLOADLINK-OrderNumber_name

Referenz: SENDUPLOADLINK-OrderNumber

Referenz: SENDUPLOADLINK-OrderNumber_error

Referenz: SENDUPLOADLINK-EmailTo_name

Referenz: SENDUPLOADLINK-EmailTo

Referenz: SENDUPLOADLINK-EmailTo_error

Referenz: BT-SendUploadLink

Referenz: WS-UserAccountLink

Schritt 7: E-Mail für Link-Versand konfigurieren (optional)

Ergänzen Sie den folgenden Abschnitt und konfigurieren Sie die Parameter.

<SendUploadLinkMail>
   Subject-Txt   =              Ihr Upload-Link
   SenderAddress =              absender@test.de
   SenderName    =              Absender - Testshop
   Template      =              mail_send_upload_link.htm #Achtung: Der Inhalt dieses Templates wird an die vom Kunden angegebene E-Mail-Adresse gesendet! (Datenschutz)
</SendUploadLinkMail>

Referenz: Abschnitt SendUploadLinkMail

Schritt 8: E-Mail-Template anlegen (optional)

Legen Sie nun ein neues Template an und speichern Sie es unter dem Namen wie beim o. g. Abschnitt SendUploadLinkMail im Parameter Template angegeben in Ihrem Template-Verzeichnis, z. B. benutzer/templates/translation.

Fügen Sie folgende Inhalte ein:

...
{WS-TplComment}
 
ACHTUNG: Der Inhalt dieses Templates wird vom Kunden an die angegebene E-Mail-Adresse gesendet.
 
Der Inhalt dieses Templates ist datenschutzrechlich relevant.
 
{/WS-TplComment}
 
Zugang zum Upload-System
 
Hallo,
 ~A-FirstName~ ~A-LastName~ hat die Bestellung mit der Bestellnummer ~SENDUPLOADLINK-OrderNumber~ in unserem Unternehmen aufgegeben.
 Upload moeglich unter: <a href="~SENDUPLOADLINK-UploadLink~">~SENDUPLOADLINK-UploadLink~</a>

Referenz: SENDUPLOADLINK-OrderNumber
Referenz: SENDUPLOADLINK-UploadLink

Schritt 9: Anzeige des Link-Versands auf der HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm) ergänzen (optional)

Fügen Sie folgenden Inhalt auf der HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm) ein: (Beispiel für Eingabe der E-Mail-Adresse und Vorbelegung der Auftragsnummer)

{ST-LoggedIn}
 {!ST-SendUploadLink_success}
 
   Upload-Link senden
   <form action="~FORM-SendUploadLink~" method="post">
        Auftragsnummer: <input type="text" name="~SENDUPLOADLINK-OrderNumber_name~" value="~WS-OrderID~" readonly>
        E-Mail-Adresse des Empfaengers: <input type="text" name="~SENDUPLOADLINK-EmailTo_name~" value="">
        <input type="submit" value="absenden" name="~BT-SendUploadLink~">
    </form>
 {/!ST-SendUploadLink_success}
 {ST-SendUploadLink_success}
    Erfolgreich versendet an: ~SENDUPLOADLINK-EmailTo~
 {/ST-SendUploadLink_success}
{/ST-LoggedIn}

Referenz: ST-LoggedIn

Referenz: ST-SendUploadLink_success

Referenz: FORM-SendUploadLink

Referenz: SENDUPLOADLINK-OrderNumber_name

Referenz: WS-OrderID

Referenz: SENDUPLOADLINK-EmailTo_name

Referenz: BT-SendUploadLink

Referenz: SENDUPLOADLINK-EmailTo

Schritt 10: Kundenkontoübersichtsseite (ws_user_account.htm) um Link erweitern (optional)

Fügen Sie auf der Kundenkontoübersichtsseite (ws_user_account.htm) folgenden Link ein, um den E-Mail-Versand des Upload-Links aufzurufen.

...
Uploadlink versenden
<a href="~WS-SendUploadLink~" class="button">zur Eingabe</a>
...

Referenz: WS-SendUploadLink

Haben Sie alle Schritte durchgeführt, ist auch der E-Mail-Versand der Upload-Links erfolgreich in Ihrem Shop integriert und aktiv.


Hinweise

Bitte beachten Sie folgende Aspekte:

Der Kunde muss angemeldet sein (ansonsten kann keine E-Mail versendet werden bzw. die Eingabe der Daten ist nicht möglich).

Die eingegebene Auftragsnummer muss mit dem aktivem Kundenkonto aufgegeben worden sein.

Es kann exakt eine E-Mail-Adresse pro Aufruf angegeben werden (es ist nicht möglich mehrere E-Mail-Adresse, z. B. durch Komma getrennt, anzugeben. Ein mehrmaliges Versenden pro Auftragsnummer ist allerdings möglich).

Aus datenschutzrechtlichen Gründen dürfen durch den Kunden keine weiteren Informationen angegeben werden, die mit an die angegebene E-Mail-Adresse gesendet werden.

Die E-Mail-Adresse des Kunden wird als ReplyTo-Adresse in die versendete E-Mail gesetzt.

Die Absender-E-Mail-Adresse und der Absender-Name werden aus dem Kundenkonto ermittelt und können vom Besteller nicht geändert werden.