> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# E-NL- (Anmeldeformular)

> Die Adressfelder des Newsletter-Empfängers im Template aufbauen: Feldname, Wert, Fehlerzustand, verstecktes Feld und die fertigen Auswahllisten für Anrede und Land.

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](https://dokumentation.websale.de/v8s/marketing-funktionen/e-marketing-manager.md)

## 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 |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{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.

> [!WARNING]
>
> Ü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.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{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}
```

> [!WARNING]
>
> 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 |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<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:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<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.

> [!WARNING]
>
> Die Auswahllisten bringen ihren Feldnamen selbst mit. Setzen Sie darum herum kein eigenes `select`-Element und keinen eigenen `name`.

## Das vollständige Beispiel

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{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)](https://dokumentation.websale.de/v8s/referenz/tags/e-nl/abonnement-verwalten.md)

## 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`.

## Verwandte Themen

* Wegweiser: [E-Marketing-Manager](https://dokumentation.websale.de/v8s/marketing-funktionen/e-marketing-manager.md)
* Materialien: [Materialien zum E-Marketing-Manager](https://dokumentation.websale.de/v8s/materialien/materialien-emarketing-manager.md)
* Referenz: [E-NL- (Seitenzustände und Meldungen)](https://dokumentation.websale.de/v8s/referenz/tags/e-nl/seitenzustaende-und-meldungen.md)
* Referenz: [E-NL- (Abonnement verwalten)](https://dokumentation.websale.de/v8s/referenz/tags/e-nl/abonnement-verwalten.md)


## Related topics

- [E-NL- (Abonnement verwalten)](https://dokumentation.websale.de/v8s/referenz/tags/e-nl/abonnement-verwalten.md)
- [E-NL- (Seitenzustände und Meldungen)](https://dokumentation.websale.de/v8s/referenz/tags/e-nl/seitenzustaende-und-meldungen.md)
- [Materialien E-Marketing-Manager](https://dokumentation.websale.de/v8s/materialien/materialien-emarketing-manager.md)
- [E-NL- (Gutschein für die Newsletter-Anmeldung)](https://dokumentation.websale.de/v8s/referenz/tags/e-nl/gutscheine.md)
- [NL- (Newsletter-Anmeldung im Bestellprozess)](https://dokumentation.websale.de/v8s/referenz/tags/nl.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.