SP- (Passwort neu setzen) - WEBSALE Dokumentation

Hat ein Käufer sein Passwort vergessen, schickt ihm der Shop eine E-Mail mit einem Link, über den er ein neues setzt. Dabei gibt es eine Besonderheit: zu einer E-Mail-Adresse können mehrere Kundenkonten gehören. Der Empfänger muss dann erkennen können, um welches Konto es geht, und für jedes einen eigenen Link bekommen. Genau dafür sind die SP-Tags da. Sie laufen über alle Konten zu dieser Adresse, beschreiben jedes einzelne und erzeugen je Konto den passenden Link. Wegweiser: Passwort vergessen Alle Tags dieser Seite gelten ausschließlich im HTML-Mailtemplate der Funktion “Passwort vergessen”. Welches Template verwendet wird, steht im Abschnitt SetPasswordMail der Shopkonfiguration.

Wie viele Konten gehören zu der Adresse

Drei Tags beantworten diese Frage, bevor es in die Einzelheiten geht.

Tag	Liefert
`SP-Data`	als Einzel-Tag die Zahl der Konten, als Schleife den Durchlauf über sie
`SP-SingleData`	Klammerung: es ist genau ein Konto
`SP-SingleDataFromMultipleAccount`	Klammerung: es geht um ein einzelnes Mehrfachkonto

{SP-SingleData}
   <p>Sie haben ein neues Passwort angefordert.</p>
{/SP-SingleData}

{!SP-SingleData}
   <p>Zu Ihrer E-Mail-Adresse gehören ~SP-Data~ Kundenkonten. Bitte wählen Sie das gewünschte aus.</p>
{/!SP-SingleData}

SP-SingleData greift, wenn genau ein Konto in der Liste steht. Das ist auch dann der Fall, wenn der Käufer aus der Übersicht seiner Mehrfachkonten heraus das Passwort für ein einzelnes davon neu setzen möchte. Welcher der beiden Fälle vorliegt, unterscheidet SP-SingleDataFromMultipleAccount. Das Shopsystem fordert das nicht, das Tag arbeitet überall im Mailtemplate. Die Verschachtelung ist trotzdem sinnvoll, denn außerhalb des Einzelkontenfalls beantwortet es keine sinnvolle Frage.

Die Schleife über die Konten

Alle Angaben zu einem einzelnen Konto stehen innerhalb der SP-Data-Schleife.

{@SP-Data}
   <p>
      {SP-Company}~SP-Company~<br>{/SP-Company}
      ~SP-FirstName~ ~SP-LastName~<br>
      {SP-CustomerID}Kundennummer ~SP-CustomerID~<br>{/SP-CustomerID}
      {SP-LastLogin}Letzte Anmeldung: ~SP-LastLogin~{/SP-LastLogin}
   </p>
   <p><a href="~SP-SetPasswordLink~">Für dieses Konto ein neues Passwort setzen</a></p>
{/@SP-Data}

Die Schleife ist auch beim Einzelkontenfall nötig. SP-SetPasswordLink und alle Angaben zum Konto sind außerhalb der SP-Data-Schleife ungültige Tags, auch innerhalb von SP-SingleData. Schreiben Sie die Kontenangaben deshalb einmal in die Schleife und steuern Sie den Text drumherum über SP-SingleData.

SP-Data gibt es nur als Einzel-Tag und als Schleife, nicht als Klammerung. Für die Fallunterscheidung nehmen Sie SP-SingleData.

Die Angaben zum Konto

Tag	Liefert
`SP-CustomerID`	die Kundennummer
`SP-Company`	die Firma aus der Rechnungsadresse
`SP-FirstName`	den Vornamen aus der Rechnungsadresse
`SP-LastName`	den Nachnamen aus der Rechnungsadresse
`SP-LastLogin`	den Zeitpunkt der letzten Anmeldung
`SP-SubAccountID`	die Kennung des Unterkontos
`SP-SetPasswordLink`	den Link zum Neusetzen des Passworts für dieses Konto

Alle Angaben außer dem Link greifen auch als Klammerung und zwar dann, wenn der Wert gefüllt ist. Das ist nützlich, weil Firma, Kundennummer und letzte Anmeldung nicht bei jedem Konto vorliegen. Bei Mehrfachkonten ist diese Kennung oft das einzige Merkmal, an dem der Empfänger die Konten auseinanderhält, wenn Name und Firma gleich sind.

Die Mail geht an eine Adresse, hinter der mehrere Personen stehen können. Geben Sie deshalb nur so viele Angaben aus, wie zum Unterscheiden nötig sind. Kundennummer und Unterkontokennung reichen meist, die letzte Anmeldung ist bereits eine Information über das Verhalten des Kontoinhabers.

SP-SetPasswordLink ist ausschließlich ein Einzel-Tag. Jeder Durchlauf der Schleife erzeugt einen eigenen Link, der genau zu diesem Konto gehört. Referenz: MA- (Mehrfachkonten)

Nach Subshop unterscheiden

In einem Shopverbund darf sich ein Mehrfachkonto nicht zwingend in jedem Subshop anmelden. SP-SubShopPermission() prüft das je Konto.

{@SP-Data}
   {SP-SubShopPermission(fachhandel)}
      <p><a href="~SP-SetPasswordLink~">Konto ~SP-CustomerID~ im Fachhandelsbereich</a></p>
   {/SP-SubShopPermission(fachhandel)}
{/@SP-Data}

Das Tag braucht genau einen Parameter, nämlich einen einzelnen Subshop. Ein Stern als Platzhalter wird abgelehnt, ebenso ein leerer Parameter oder mehrere Angaben. In allen drei Fällen ist das Tag ungültig.

SP-SubShopPermission() gibt es nur als Klammerung und nur innerhalb der SP-Data-Schleife.

Die Tags im Überblick

Tag	Einzel-Tag	Bereichs-Tag	negatives Bereichs-Tag	Schleifen-Tag
`SP-Data`	ja	–	–	ja
`SP-SingleData`	–	ja	ja	–
`SP-SingleDataFromMultipleAccount`	–	ja	ja	–
`SP-SetPasswordLink`	ja	–	–	–
`SP-SubAccountID`	ja	ja	ja	–
`SP-CustomerID`	ja	ja	ja	–
`SP-Company`	ja	ja	ja	–
`SP-FirstName`	ja	ja	ja	–
`SP-LastName`	ja	ja	ja	–
`SP-LastLogin`	ja	ja	ja	–
`SP-SubShopPermission()`	–	ja	ja	–

Alle Tags gelten ausschließlich im Mailtemplate der Funktion “Passwort vergessen”. SP-Data, SP-SingleData und SP-SingleDataFromMultipleAccount stehen dort frei, alle übrigen innerhalb der SP-Data-Schleife. Liegt kein Vorgang zum Neusetzen des Passworts vor, geben alle Tags nichts aus.

​Wie viele Konten gehören zu der Adresse

​Die Schleife über die Konten

​Die Angaben zum Konto

​Nach Subshop unterscheiden

​Die Tags im Überblick

​Verwandte Themen

Wie viele Konten gehören zu der Adresse

Die Schleife über die Konten

Die Angaben zum Konto

Nach Subshop unterscheiden

Die Tags im Überblick

Verwandte Themen