E-NL- (Anmeldeformular) - WEBSALE Dokumentation

Wer sich für den Newsletter anmeldet, hinterlässt mindestens seine E-Mail-Adresse. Je nach Shop kommen Anrede, Name und Anschrift dazu, weil der Newsletter personalisiert verschickt werden soll. Die Tags mit dem Präfix E-NL-A- bauen diese Felder im Template auf. Sie folgen alle demselben Raster, es gibt sie also nur einmal zu lernen. Wegweiser: E-Marketing-Manager

Das Raster

Zu jedem Adressfeld gehören bis zu vier Tags.

Schreibweise	Liefert
`E-NL-A-<Feld>_name`	den Feldnamen für das HTML-Element
`E-NL-A-<Feld>`	den bisherigen Wert
`E-NL-A-<Feld>_error`	die Zeichenkette `_error`, und als Bereichs-Tag die Prüfung auf einen Fehler
`E-NL-A-<Feld>_hidden`	ein vollständiges verstecktes Feld mit Name und Wert

{E-NL-SEC-Subscribe}
   <label for="ort">Ort</label>
   <input type="text"
          id="ort"
          name="~E-NL-A-City_name~"
          value="~E-NL-A-City~"
          class="eingabe~E-NL-A-City_error~">

   {E-NL-A-City_error}
      <p class="fehler">Bitte geben Sie einen Ort an.</p>
   {/E-NL-A-City_error}
{/E-NL-SEC-Subscribe}

_error ist als Einzel-Tag dafür gedacht, an eine CSS-Klasse angehängt zu werden. Aus class="eingabe~E-NL-A-City_error~" wird im Fehlerfall class="eingabe_error" und sonst class="eingabe". Damit färbt sich das fehlerhafte Feld ein, ohne dass im Template eine Fallunterscheidung nötig wäre.

Übernehmen Sie den Feldnamen immer aus _name. Ein selbst gewählter Name kommt beim E-Marketing-Manager nicht an, die Eingabe geht dann beim Absenden verloren.Die Tags werden nur innerhalb der Bereiche E-NL-SEC-Subscribe und E-NL-SEC-Manage ausgewertet. Außerhalb bleiben sie leer.

Die Felder

Feld	`_name`	Wert	`_error`	`_hidden`
`E-NL-A-Salutation`	ja	ja	ja	ja
`E-NL-A-Title`	ja	ja	ja	ja
`E-NL-A-FirstName`	ja	ja	ja	ja
`E-NL-A-LastName`	ja	ja	ja	ja
`E-NL-A-Company`	ja	ja	ja	ja
`E-NL-A-Street1`	ja	ja	ja	ja
`E-NL-A-Street2`	ja	ja	ja	ja
`E-NL-A-Zip`	ja	ja	ja	ja
`E-NL-A-City`	ja	ja	ja	ja
`E-NL-A-Country`	ja	ja	ja	ja
`E-NL-A-E-mail`	ja	ja	ja	–

Die E-Mail-Adresse ist das einzige Feld ohne _hidden. Sie ist der Schlüssel des Abonnenten und muss deshalb immer sichtbar eingegeben oder bestätigt werden.

Versteckte Felder

Nicht jedes Formular soll alle Felder zeigen. Ein Feld, das der Besucher nicht sehen soll, dessen Wert aber erhalten bleiben muss, kommt als verstecktes Feld ins Formular.

{E-NL-SEC-Manage}
   <!-- sichtbar: nur Anrede und Name -->
   <input type="text" name="~E-NL-A-FirstName_name~" value="~E-NL-A-FirstName~">
   <input type="text" name="~E-NL-A-LastName_name~" value="~E-NL-A-LastName~">

   <!-- unsichtbar, aber erhalten -->
   ~E-NL-A-Street1_hidden~
   ~E-NL-A-Zip_hidden~
   ~E-NL-A-City_hidden~
{/E-NL-SEC-Manage}

Ohne verstecktes Feld verliert der Abonnent beim Speichern alle Angaben, die im Formular nicht vorkommen. Das _hidden-Tag erzeugt dafür das komplette input-Element, Sie schreiben nur das Tag hin.

Die fertigen Auswahllisten

Für Anrede und Land baut der E-Marketing-Manager die Auswahlliste selbst, samt aller Einträge.

Tag	Erzeugt
`E-NL-INPUT-Salutation()`	die Auswahlliste der Anreden
`E-NL-INPUT-Country()`	die Auswahlliste der Länder

<label for="anrede">Anrede</label>
~E-NL-INPUT-Salutation(Frau,class="anrede" id="anrede")~

<label for="land">Land</label>
~E-NL-INPUT-Country(deu,class="land" id="land")~

Daraus wird im Shop:

<label for="land">Land</label>
<select name="<der Feldname aus E-NL-A-Country_name>" class="land" id="land">
   <option></option>
   <option value="deu" selected>Deutschland</option>
   <option value="aut">Österreich</option>
   ...
</select>

Parameter	Bedeutung
1	der Eintrag, der vorausgewählt sein soll
2	zusätzliche Attribute für das `select`-Element

Beide Parameter sind optional. Ohne Vorauswahl steht der leere Eintrag oben. Soll nur etwas an den Attributen stehen und nichts vorausgewählt sein, lassen Sie den ersten Parameter leer.

Die Auswahllisten bringen ihren Feldnamen selbst mit. Setzen Sie darum herum kein eigenes select-Element und keinen eigenen name.

Das vollständige Beispiel

{E-NL-SEC-Subscribe}
   <fieldset>
      <legend>Newsletter abonnieren</legend>

      <label for="nl-mail">E-Mail-Adresse</label>
      <input type="email"
             id="nl-mail"
             name="~E-NL-A-E-mail_name~"
             value="~E-NL-A-E-mail~"
             class="eingabe~E-NL-A-E-mail_error~"
             required>

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

      <label for="nl-anrede">Anrede</label>
      ~E-NL-INPUT-Salutation(,id="nl-anrede")~

      <label for="nl-vorname">Vorname</label>
      <input type="text"
             id="nl-vorname"
             name="~E-NL-A-FirstName_name~"
             value="~E-NL-A-FirstName~"
             class="eingabe~E-NL-A-FirstName_error~">

      <label for="nl-nachname">Nachname</label>
      <input type="text"
             id="nl-nachname"
             name="~E-NL-A-LastName_name~"
             value="~E-NL-A-LastName~"
             class="eingabe~E-NL-A-LastName_error~">

      <button type="submit">Anmelden</button>
   </fieldset>
{/E-NL-SEC-Subscribe}

Die Zielgruppen, für die sich der Besucher anmeldet, gehören ebenfalls in dieses Formular. Sie sind auf der Seite zur Abo-Verwaltung beschrieben, weil dieselben Tags auch dort zum Einsatz kommen. Referenz: E-NL- (Abonnement verwalten)

Die Tags im Überblick

Tag	Einzel-Tag	Bereichs-Tag	negatives Bereichs-Tag	Schleifen-Tag
`E-NL-A-<Feld>`	ja	–	–	–
`E-NL-A-<Feld>_name`	ja	–	–	–
`E-NL-A-<Feld>_error`	ja	ja	ja	–
`E-NL-A-<Feld>_hidden`	ja	–	–	–
`E-NL-INPUT-Salutation()`	ja	–	–	–
`E-NL-INPUT-Country()`	ja	–	–	–

Zulässig sind alle Tags im Template, das in der Shopkonfiguration shop.config im Abschnitt <eMarketingManager> beim Parameter Manage eingetragen ist, jeweils innerhalb von E-NL-SEC-Subscribe oder E-NL-SEC-Manage.

​Das Raster

​Die Felder

​Versteckte Felder

​Die fertigen Auswahllisten

​Das vollständige Beispiel

​Die Tags im Überblick

​Verwandte Themen

Das Raster

Die Felder

Versteckte Felder

Die fertigen Auswahllisten

Das vollständige Beispiel

Die Tags im Überblick

Verwandte Themen