SENDUPLOADLINK- (Sending the upload link by email)

When a customer uploads print data or documents for an order, it is often not the customer themselves who does this, but their graphics department or an agency. For this purpose, there is the “Send upload link by email” form: the customer enters an order number and an email address, and the shop sends the matching upload link there. The SENDUPLOADLINK- tags build this form and output the link in the email sent. Seven tags are enough for this, because there are only two input fields. Guide: Uploading files

All tags on this page require a logged-in buyer. If nobody is logged in, they are treated as an invalid tag. The previous documentation only names “All” as the permitted templates and omits this condition.

The form

Two fields, one button, one form.

Tag	Returns
`FORM-SendUploadLink`	the target of the form
`SENDUPLOADLINK-OrderNumber_name`	the HTML name of the field for the order number
`SENDUPLOADLINK-OrderNumber`	the order number entered so far
`SENDUPLOADLINK-EmailTo_name`	the HTML name of the field for the recipient address
`SENDUPLOADLINK-EmailTo`	the recipient address entered so far
`BT-SendUploadLink`	the HTML name of the submit button

<form action="~FORM-SendUploadLink~" method="post">
   <label>
      Auftragsnummer
      <input type="text" name="~SENDUPLOADLINK-OrderNumber_name~" value="~SENDUPLOADLINK-OrderNumber~">
   </label>

   <label>
      E-Mail-Adresse des Empfängers
      <input type="email" name="~SENDUPLOADLINK-EmailTo_name~" value="~SENDUPLOADLINK-EmailTo~">
   </label>

   <input type="submit" name="~BT-SendUploadLink~" value="Uploadlink senden">
</form>

The two value tags return what the customer last entered. After an incorrect entry, the form thus fills itself in again. As range tags, they apply if anything at all was entered, which is suitable for a preview of the details.

The _name tags return the fixed names ws_input_upload_sendlink_ordernumber and ws_input_upload_sendlink_email. Nevertheless, use the tags so that the template continues to work even after a renaming.

The two _name tags and the submit button are pure single tags. As range tags, they are treated as an invalid tag.

Reference: FORM-SendUploadLink on the page FORM- (Forms)
Reference: BT-SendUploadLink on the page BT- (Buttons)

Incorrect entries

Both fields are checked as soon as the customer submits. There is a range for each.

Tag	Applies
`SENDUPLOADLINK-OrderNumber_error`	if the order number is not permitted
`SENDUPLOADLINK-EmailTo_error`	if the email address is not permitted

{SENDUPLOADLINK-OrderNumber_error}
   <p class="fehler">Zu dieser Auftragsnummer finden wir keinen Auftrag in Ihrem Konto.</p>
{/SENDUPLOADLINK-OrderNumber_error}

{SENDUPLOADLINK-EmailTo_error}
   <p class="fehler">Bitte geben Sie eine gültige E-Mail-Adresse an.</p>
{/SENDUPLOADLINK-EmailTo_error}

The order number is only considered permitted if it belongs to the account of the logged-in customer. So nobody can have the upload link for someone else’s order sent to them. Word the error text accordingly, because “Invalid order number” does not describe the situation. The previous documentation says nothing about this check.

Both tags exist only as range tags, and they only apply after submission. On the first call of the form, they do not report an error.

The shop system enters the address of the logged-in customer as the reply address of the email sent. The recipient can therefore reply directly.

The link in the email

The email is generated from a separate mail template. It contains exactly one tag from this page.

Hier können Sie die Daten zum Auftrag ~SENDUPLOADLINK-OrderNumber~ hochladen:
<a href="~SENDUPLOADLINK-UploadLink~">~SENDUPLOADLINK-UploadLink~</a>

SENDUPLOADLINK-UploadLink belongs exclusively in the mail template. Only there is the order number available with which the link is built. In the form template, the tag does not return the link for this order number.

The generated link contains the order number and a checksum. It works without logging in, because the recipient does not have an account in the shop. Accordingly, the email should only go to addresses that the customer trusts.

Which template is used, what the subject is and from which address the email comes is defined in the SendUploadLinkMail section of the shop configuration.

Reference: SendUploadLinkMail section in the shop configuration

After sending

If sending was successful and the order has already been completed, the shop system forwards the customer to the order receipt confirmation instead of displaying the form again. With a background call via JavaScript, on the other hand, the form remains, so that you can set the feedback yourself.

For your own success message on the form, the background call is the suitable route. The customer then stays on the page, and you show them right there that the email is on its way.

Sending without a form

If the customer should not have to type, there is the route via WS-SendUploadLink(). The tag belongs to the WS- prefix and generates a link to the form. It accepts up to three arguments: the order number, the email address and yes, which triggers sending without further action.

<a href="~WS-SendUploadLink(~WS-UploadOrderNumber~)~">
   Uploadlink an eine andere Adresse schicken
</a>

With the order number as the argument, the customer arrives at a form that is already filled in. This is the usual route from the order history.

Reference: WS-SendUploadLink on the page WS- (General tags)

The tags at a glance

Tag	Single tag	Range tag	Negative range tag	Loop tag
`SENDUPLOADLINK-OrderNumber`	yes	yes	yes	–
`SENDUPLOADLINK-OrderNumber_name`	yes	–	–	–
`SENDUPLOADLINK-OrderNumber_error`	–	yes	yes	–
`SENDUPLOADLINK-EmailTo`	yes	yes	yes	–
`SENDUPLOADLINK-EmailTo_name`	yes	–	–	–
`SENDUPLOADLINK-EmailTo_error`	–	yes	yes	–
`SENDUPLOADLINK-UploadLink`	yes	–	–	–

The first six tags belong in the form template, SENDUPLOADLINK-UploadLink in the mail template. All seven require a logged-in buyer.

Guide: Uploading files
Reference: FORM- (Forms)
Reference: BT- (Buttons)
Reference: WS- (General tags)

​The form

​Incorrect entries

​The link in the email

​After sending

​Sending without a form

​The tags at a glance

​Related topics

The form

Incorrect entries

The link in the email

After sending

Sending without a form

The tags at a glance

Related topics