Zum Hauptinhalt springen
Das Abo-Modul verschickt vier E-Mails: zwei Ankündigungen vor der nächsten Abo-Bestellung und zwei Fehlermeldungen an den Händler. Die Tags mit dem Präfix E-SUBS_ gelten ausschließlich in den Templates dieser E-Mails. Alle vier tragen Sie in der Shopkonfiguration shop.config im Abschnitt Subscription ein, jede in ihrem eigenen Unterabschnitt. Wegweiser: Abo-Modul · Referenz: Abschnitt Subscription · Materialien: Materialien Abo-Modul Die Abo-Verwaltung im Kundenkonto ist eine andere Baustelle. Sie arbeitet mit den Tags des Präfixes SUBS-, nicht mit den E-SUBS_Tags dieser Seite.
Der Parameter Days in den beiden Ankündigungsmails bestimmt, wie viele Tage vor der Bestellung die E-Mail hinausgeht. Bei einem kurzen Lieferintervall kann eine zu große Vorlaufzeit dazu führen, dass die Ankündigung vor der vorherigen Lieferung eintrifft.

​
Die Schleife über die Abos

Zwei Schleifen stehen zur Wahl. Welche passt, hängt davon ab, wer die E-Mail bekommt.
Die Gruppierung nach Produkt ist für die Händler-Ankündigung gedacht. Der Händler will wissen, wie viel von welchem Artikel demnächst rausgeht, nicht welcher Kunde was bestellt hat. Der Käufer dagegen bekommt seine eigenen Abos einzeln aufgelistet.
Die beiden Schleifen lassen sich nicht ineinander schachteln. Steht {@E-SUBS_DataByProduct} innerhalb von {@E-SUBS_Data}, bleibt der innere Bereich leer. Entscheiden Sie sich je E-Mail für eine der beiden.
E-SUBS_DataByProduct lässt sich zusätzlich klammern. Der Bereich greift, wenn überhaupt gruppierte Abos vorliegen, und hält Tabellenkopf und Überschrift aus einer sonst leeren Mail heraus.

​
Die Angaben zum Abo

Alle folgenden Tags stehen innerhalb der Schleife und beziehen sich auf das gerade durchlaufene Abo.
Diese Tags sind reine Einzel-Tags. Diese Klammerung greift nicht, das Tag bleibt unaufgelöst in der E-Mail stehen. Prüfen Sie auf leere Werte nicht im Template, sondern verlassen Sie sich darauf, dass die Angaben zu einem bestehenden Abo vorhanden sind.
Produktname und Preis sind der Stand der letzten Bestellung beziehungsweise der letzten Änderung am Abo, nicht der heutige Katalogpreis. In der Ankündigung an den Käufer ist das die ehrlichere Angabe, weil sie zeigt, was zuletzt berechnet wurde. Weisen Sie im Text darauf hin, dass sich der Preis bis zur Lieferung ändern kann. Das Tag gibt aus, mit wie vielen Nachkommastellen die Menge geführt wird, was bei Gewichts- oder Längenartikeln nötig ist.

​
Zeitpunkte

Bei E-SUBS_Data_nextorder ist nur der Datumsanteil aussagekräftig. Die Uhrzeit darin ergibt sich aus dem Sammellauf und sagt nichts über den Zeitpunkt der Lieferung aus. Geben Sie dem Käufer deshalb nur das Datum aus.
Alle vier Zeitpunkte kommen als Zeitstempel. Für eine lesbare Ausgabe formatieren Sie sie im Template, beispielsweise mit den Tags zur Datumsformatierung.

​
Der Zustand eines Abos

Die vier Zustände schließen einander aus. Ein Abo ist entweder aktiv oder neu oder pausiert oder angestoßen, nie zweierlei zugleich. Eine Kette aus positiven Klammerungen deckt deshalb alle Fälle ab, eine Verschachtelung ist nicht nötig.Die Werte 0 für “nicht betroffen”, 1 für “geändert”, 2 für “pausiert” und 3 für “fortgesetzt” gehören nicht zu diesem Tag, sondern beschreiben die Änderungsarten der Abo-Verwaltung. Der Zahlenwert hier entspricht den vier oben genannten Zuständen. Verwenden Sie die vier state_is…-Klammerungen, die sind eindeutig, und greifen Sie nicht auf den Zahlenwert zurück.

​
Prüfen, ob ein Produkt abonniert ist

Beide Tags prüfen die gesamte Abo-Liste, nicht nur das gerade durchlaufene Abo. Sie stehen deshalb außerhalb der Schleife und eignen sich, um in einer E-Mail gezielt auf ein bestimmtes Produkt einzugehen.

​
Die beiden Fehler-E-Mails

E-SUBS_ErrorCode gilt nur im Template für OrderErrorMail. E-SUBS_ErrorMsg steht in allen Abo-Templates zur Verfügung.
Beide Fehler-E-Mails gehen an den Händler und nennen Kundenkonto und Produkt. Schicken Sie sie an eine interne Adresse und nicht an ein Postfach, das Dritte einsehen können.Die Meldung über endgültig abgeschaltete Abos wird nur verschickt, wenn für den Shop ein Secret für Deeplink-Mails konfiguriert ist. Fehlt es, unterbleibt der Versand und es erscheint lediglich ein Eintrag im Protokoll. Dasselbe gilt, wenn Empfängeradresse, Absenderadresse, Betreff oder Template fehlen oder das Template leer ist.

​
Die Tags im Überblick

Zulässig sind alle Tags dieser Seite in den vier E-Mail-Templates des Abo-Moduls. Die Data_Tags jeweils innerhalb einer der beiden Schleifen, E-SUBS_ErrorCode nur im Template für OrderErrorMail.

​
Verwandte Themen