Download-Template: Tags

Verkauft ein Shop Download-Produkte, bekommt der Käufer nach der Bestellung eine Download-ID. Damit ruft er eine eigene Seite auf, auf der seine Dateien zum Herunterladen bereitstehen. Diese Seite ist das Download-Template. Das Template enthält vier Abschnitte, von denen der Shop jeweils nur einen anzeigt. Welcher es ist, entscheidet sich aus dem Aufruf: mit gültiger Download-ID, ohne ID, nach der Anmeldung im Shop oder nach einem Fehler. Wegweiser: Download-Produkte anbieten

Abschnitt	Wird angezeigt
`DownloadError`	wenn ein Download nicht möglich war
`DownlIdInput`	wenn der Aufruf ohne Download-ID erfolgte
`OrderList`	wenn ein angemeldeter Käufer seine Bestellungen mit Download-Produkten aufruft
`ArticleList`	wenn die Dateien einer Bestellung angezeigt werden

Die Tags dieses Templates tragen kein Präfix. Msg, OrderNumber oder File heißen genau so und gelten nur hier. Mit den gleichnamigen Tags anderer Templates haben sie nichts zu tun.

Jeder Abschnitt wird als Bereich geklammert. Was außerhalb aller vier Bereiche steht, beispielsweise Kopf- und Fußzeile, erscheint immer.

Der Aufbau des Templates

{DownloadError}
   <!-- Ein Download war nicht möglich -->
{/DownloadError}

{DownlIdInput}
   <!-- Der Käufer soll seine Download-ID eingeben -->
{/DownlIdInput}

{OrderList}
   <!-- Die Bestellungen des angemeldeten Käufers -->
{/OrderList}

{ArticleList}
   <!-- Die Dateien einer Bestellung -->
{/ArticleList}

DownloadError: der Fehlerfall

Dieser Abschnitt erscheint, wenn ein angeforderter Download nicht ausgeliefert wurde, beispielsweise weil die Anzahl der erlaubten Downloads erschöpft oder der Zeitraum abgelaufen ist.

Tag	Liefert
`DownloadID`	die Download-ID
`PrdName`	den Namen des Produkts
`ErrMsg`	die Fehlermeldung

{DownloadError}
   <h1>Download nicht möglich</h1>
   <p>~ErrMsg~</p>
   <p>Betroffenes Produkt: ~PrdName~ (Download-ID ~DownloadID~)</p>
{/DownloadError}

Der Text in ErrMsg stammt aus den Fehlermeldungen des Download-Moduls. In den Meldungen zur überschrittenen Anzahl und zum abgelaufenen Zeitraum dürfen die Platzhalter ~maxdownloads~ und ~expdt~ stehen. Der Shop ersetzt sie durch die erlaubte Anzahl beziehungsweise das Ablaufdatum.

DownlIdInput: die Eingabe der Download-ID

Dieser Abschnitt erscheint, wenn die Seite ohne Download-ID aufgerufen wurde oder die angegebene ID nicht stimmt. Der Käufer bekommt dann ein Eingabefeld.

Tag	Liefert
`Msg`	einen allgemeinen Hinweistext
`DownloadID`	die zuletzt angegebene Download-ID

{DownlIdInput}
   <p>~Msg~</p>
   <form method="post">
      <label for="downloadid">Ihre Download-ID</label>
      <input type="text" id="downloadid" name="DownloadId" value="~DownloadID~">
      <button type="submit">Weiter</button>
   </form>
{/DownlIdInput}

Msg enthält im Fehlerfall den Hinweis auf die ungültige ID und ist sonst leer. Ein eigener Einleitungstext gehört deshalb fest ins Template und nicht in dieses Tag.

Zwischen zwei Download-Versuchen wartet der Shop bewusst eine Sekunde, damit sich Download-IDs nicht durchprobieren lassen. Bauen Sie deshalb keine automatischen Wiederholungen in das Formular ein.

OrderList: die Bestellungen des Käufers

Dieser Abschnitt erscheint, wenn ein im Shop angemeldeter Käufer seine Bestellungen mit Download-Produkten aufruft.

Tag	Liefert
`Msg`	einen allgemeinen Hinweistext
`Orders`	die Schleife über die Bestellungen
`NoOrders`	greift, wenn es keine Bestellung mit Download-Produkten gibt
`OrderNumber`	die Bestellnummer
`OrderDateTime`	Datum und Uhrzeit
`ShowArtsUrl`	die Adresse, unter der die Dateien dieser Bestellung erscheinen
`DownloadAllowed`	greift, wenn mindestens eine Datei noch heruntergeladen werden darf
`DownloadDone`	greift, wenn mindestens eine Datei bereits heruntergeladen wurde

{OrderList}
   <p>~Msg~</p>

   {NoOrders}
      <p>Sie haben noch keine Bestellung mit Download-Produkten.</p>
   {/NoOrders}

   <ul>
      {@Orders}
         <li>
            <a href="~ShowArtsUrl~">Bestellung ~OrderNumber~ vom ~OrderDateTime~</a>
            {DownloadAllowed}<span class="offen">Downloads möglich</span>{/DownloadAllowed}
            {DownloadDone}<span class="erledigt">bereits heruntergeladen</span>{/DownloadDone}
         </li>
      {/@Orders}
   </ul>
{/OrderList}

Orders ist ein reines Schleifen-Tag und wird mit {@Orders} geöffnet. Eine einfache Klammerung {Orders} bleibt wirkungslos. Für die Frage, ob es überhaupt Bestellungen gibt, ist NoOrders da.

OrderDateTime ist der Zeitpunkt, zu dem die Download-Produkte in die Download-Verwaltung aufgenommen wurden. Das ist in der Regel der Bestellzeitpunkt, muss ihm aber nicht auf die Sekunde entsprechen. DownloadAllowed und DownloadDone schließen sich nicht aus. Eine Bestellung mit mehreren Dateien kann beides zugleich sein.

ArticleList: die Dateien einer Bestellung

Dieser Abschnitt zeigt die Download-Produkte einer Bestellung.

Tag	Liefert
`Msg`	einen allgemeinen Hinweistext
`OrderNumber`	die Bestellnummer
`DownloadID`	die Download-ID
`Articles`	die Schleife über die Produkte
`PrdName`	den Produktnamen
`PrdNumber`	die Produktnummer
`PrdThumbnailURL`	die Adresse des Vorschaubildes
`File`	den Dateinamen
`FileSize`	die Dateigröße in passender Einheit
`DownloadsDone`	die Anzahl der bereits erfolgten Downloads
`Downloads`	die Anzahl der erlaubten Downloads
`ValidDateTime`	den Zeitpunkt, bis zu dem heruntergeladen werden darf
`DownloadAllowed`	greift, wenn die Datei noch heruntergeladen werden darf
`DownloadUrl`	die Adresse, die den Download startet
`Back`	greift, wenn der Aufruf aus `OrderList` kam

{ArticleList}
   <p>~Msg~</p>
   <h1>Bestellung ~OrderNumber~</h1>

   <table>
      {@Articles}
         <tr>
            <td>
               {PrdThumbnailURL}<img src="~PrdThumbnailURL~" alt="">{/PrdThumbnailURL}
            </td>
            <td>
               ~PrdName~<br>
               <small>~PrdNumber~</small>
            </td>
            <td>~File~ (~FileSize~)</td>
            <td ~ddwrnclass~>~DownloadsDone~ von ~Downloads~</td>
            <td ~vdwrnclass~>~ValidDateTime~</td>
            <td>
               {DownloadAllowed}
                  <a href="~DownloadUrl~">Herunterladen</a>
               {/DownloadAllowed}
               {!DownloadAllowed}
                  <span>nicht mehr verfügbar</span>
               {/!DownloadAllowed}
            </td>
         </tr>
      {/@Articles}
   </table>

   {Back}
      <a href="javascript:history.back()">Zurück zur Übersicht</a>
   {/Back}
{/ArticleList}

Auch Articles ist ein reines Schleifen-Tag und wird mit {@Articles} geöffnet.

Was die Zähler wirklich ausgeben

Downloads und ValidDateTime geben nicht immer eine Zahl beziehungsweise ein Datum aus. Ist die Anzahl unbegrenzt, steht dort der Text für “unbegrenzt”, ebenso beim Zeitraum. Wurde der Download gestoppt, steht in ValidDateTime der Text für “gestoppt”. Rechnen Sie im Template deshalb nicht mit diesen Werten. FileSize gibt einen Bindestrich aus, wenn die Datei auf dem Server nicht mehr vorhanden ist. Das ist der schnellste Weg, ein verschwundenes Download-Produkt zu erkennen. File enthält nur den Dateinamen ohne Verzeichnis, und DownloadUrl ist nur dann gefüllt, wenn der Download tatsächlich noch erlaubt ist. Setzen Sie den Link deshalb innerhalb von {DownloadAllowed}.

Erschöpfte und abgelaufene Downloads hervorheben

Zwei weitere Tags liefern eine fertige CSS-Klasse für den Warnfall.

Tag	Liefert
`ddwrnclass`	ein `class`-Attribut, wenn die erlaubte Anzahl erreicht ist
`vdwrnclass`	ein `class`-Attribut, wenn der Zeitraum abgelaufen ist

<td ~ddwrnclass~>~DownloadsDone~ von ~Downloads~</td>
<td ~vdwrnclass~>~ValidDateTime~</td>

Die Tags geben das vollständige Attribut aus, also class='warning', und sonst nichts. Sie gehören deshalb ohne eigenen Attributnamen direkt in das öffnende Element.

Die Tags im Überblick

Tag	Abschnitt	Einzel-Tag	Bereichs-Tag	negatives Bereichs-Tag	Schleifen-Tag
`DownloadError`	Template	–	ja	ja	–
`DownlIdInput`	Template	–	ja	ja	–
`OrderList`	Template	–	ja	ja	–
`ArticleList`	Template	–	ja	ja	–
`DownloadID`	DownloadError, DownlIdInput, ArticleList	ja	–	–	–
`PrdName`	DownloadError, ArticleList	ja	–	–	–
`ErrMsg`	DownloadError	ja	–	–	–
`Msg`	DownlIdInput, OrderList, ArticleList	ja	–	–	–
`Orders`	OrderList	–	–	–	ja
`NoOrders`	OrderList	–	ja	ja	–
`OrderNumber`	OrderList, ArticleList	ja	–	–	–
`OrderDateTime`	OrderList, ArticleList	ja	–	–	–
`ShowArtsUrl`	OrderList	ja	–	–	–
`DownloadAllowed`	OrderList, ArticleList	–	ja	ja	–
`DownloadDone`	OrderList	–	ja	ja	–
`Articles`	ArticleList	–	–	–	ja
`PrdNumber`	ArticleList	ja	–	–	–
`PrdThumbnailURL`	ArticleList	ja	ja	ja	–
`File`	ArticleList	ja	–	–	–
`FileSize`	ArticleList	ja	–	–	–
`DownloadsDone`	ArticleList	ja	–	–	–
`Downloads`	ArticleList	ja	–	–	–
`ValidDateTime`	ArticleList	ja	–	–	–
`DownloadUrl`	ArticleList	ja	–	–	–
`ddwrnclass`	ArticleList	ja	–	–	–
`vdwrnclass`	ArticleList	ja	–	–	–
`Back`	ArticleList	–	ja	ja	–

Zulässig sind alle Tags ausschließlich im Download-Template, jeweils innerhalb des angegebenen Abschnitts.

Referenz

Der Aufbau des Templates

DownloadError: der Fehlerfall

DownlIdInput: die Eingabe der Download-ID

OrderList: die Bestellungen des Käufers

ArticleList: die Dateien einer Bestellung

Was die Zähler wirklich ausgeben

Erschöpfte und abgelaufene Downloads hervorheben

Die Tags im Überblick

Verwandte Themen

​Der Aufbau des Templates

​DownloadError: der Fehlerfall

​DownlIdInput: die Eingabe der Download-ID

​OrderList: die Bestellungen des Käufers

​ArticleList: die Dateien einer Bestellung

​Was die Zähler wirklich ausgeben

​Erschöpfte und abgelaufene Downloads hervorheben

​Die Tags im Überblick

​Verwandte Themen

Der Aufbau des Templates

DownloadError: der Fehlerfall

DownlIdInput: die Eingabe der Download-ID

OrderList: die Bestellungen des Käufers

ArticleList: die Dateien einer Bestellung

Was die Zähler wirklich ausgeben

Erschöpfte und abgelaufene Downloads hervorheben

Die Tags im Überblick

Verwandte Themen