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

# NL- (Newsletter-Anmeldung im Bestellprozess)

> Die Newsletter-Checkbox im Shop-Template: alle konfigurierten Newsletter durchlaufen, Feldnamen setzen und die Abwahl zuverlässig erkennen.

Der bequemste Weg zu einem Newsletter-Abonnenten ist die Checkbox im Bestellprozess. Dafür gibt es die Tags mit dem Präfix `NL-`.

Sie gehören in die Templates des Shops, nicht in den E-Marketing-Manager. Die Newsletter selbst, auf die sich die Checkboxen beziehen, stehen in der Shopkonfiguration `shop.config`.

Wegweiser: [E-Marketing-Manager](https://dokumentation.websale.de/v8s/marketing-funktionen/e-marketing-manager.md)

## Das vollständige Beispiel

`NL-Data` ist zugleich die Prüfung, ob es überhaupt Newsletter gibt, und die Schleife über alle konfigurierten.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{NL-Data}
   <fieldset>
      <legend>Newsletter</legend>

      {@NL-Data}
         <input type="checkbox"
                id="~NL-Input~"
                name="~NL-Input~"
                ~NL-Checked~>
         <label for="~NL-Input~">~NL-Name~</label>

         <input type="hidden" name="~NL-ProofDeselect_hiddeninput~" value="yes">
      {/@NL-Data}
   </fieldset>
{/NL-Data}
```

> [!WARNING]
>
> Das versteckte Feld `NL-ProofDeselect_hiddeninput` gehört zu jeder Checkbox dazu. Ein Browser schickt eine **abgewählte** Checkbox gar nicht mit. Ohne das versteckte Feld kann der Shop deshalb nicht unterscheiden, ob der Käufer die Zustimmung zurückgenommen hat oder ob die Checkbox auf dieser Seite einfach nicht stand. Eine Abmeldung würde dann verloren gehen.

| Tag | Liefert |
| - | - |
| `NL-Data` | die Prüfung auf vorhandene Newsletter und die Schleife darüber |
| `NL-Name` | den konfigurierten Namen des Newsletters |
| `NL-ID` | die konfigurierte Kennung |
| `NL-Input` | den Feldnamen der Checkbox |
| `NL-Checked` | `checked`, wenn dieser Newsletter gewählt ist |
| `NL-ProofDeselect_hiddeninput` | den Feldnamen des zugehörigen versteckten Feldes |

## Die Vorbelegung

`NL-Checked` gibt `checked` aus, wenn der Käufer den Newsletter gewählt hat. Hat er noch gar nichts gewählt, entscheidet die Voreinstellung aus der Shopkonfiguration.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@NL-Data}
   <input type="checkbox" id="~NL-Input~" name="~NL-Input~" ~NL-Checked~>
   <label for="~NL-Input~">~NL-Name~</label>
{/@NL-Data}
```

> [!WARNING]
>
> Eine vorangehakte Checkbox ist rechtlich heikel. Ob die Voreinstellung im Shop gesetzt werden darf, richtet sich nach dem Einsatzland und nach der Art des Newsletters. Klären Sie das, bevor Sie sie aktivieren.

`NL-Checked` lässt sich auch klammern. Damit blenden Sie zusätzliche Hinweise nur bei gewähltem oder nur bei abgewähltem Newsletter ein.

## Einzelne Newsletter ansprechen

`NL-Name` und `NL-ID` vergleichen als Bereichs-Tag den aktuellen Newsletter mit dem Wert in den Klammern. Damit lässt sich einer von mehreren Newslettern anders darstellen.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@NL-Data}
   {NL-ID(kundennews)}
      <p class="hervorgehoben">Unser Hauptnewsletter, einmal im Monat.</p>
   {/NL-ID(kundennews)}

   <input type="checkbox" id="~NL-Input~" name="~NL-Input~" ~NL-Checked~>
   <label for="~NL-Input~">~NL-Name~</label>
   <input type="hidden" name="~NL-ProofDeselect_hiddeninput~" value="yes">
{/@NL-Data}
```

Der Vergleich achtet nicht auf Groß- und Kleinschreibung. `{NL-ID(KundenNews)}` und `{NL-ID(kundennews)}` greifen gleichermaßen.

> [!WARNING]
>
> Vergleichen Sie über `NL-ID` und nicht über `NL-Name`. Der Name ist ein Anzeigetext und kann sich ändern, die Kennung bleibt.

## Kein Newsletter konfiguriert

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{!NL-Data}
   <!-- Kein Newsletter eingerichtet, der ganze Block entfällt -->
{/!NL-Data}
```

Die äußere Klammerung `{NL-Data}` hält Überschrift und Rahmen aus der Seite heraus, solange kein Newsletter eingerichtet ist. Ohne sie steht im Bestellprozess eine leere Box.

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `NL-Data` | – | ja | ja | ja |
| `NL-Name()` | ja | ja | ja | – |
| `NL-ID()` | ja | ja | ja | – |
| `NL-Input` | ja | ja | ja | – |
| `NL-Checked` | ja | ja | ja | – |
| `NL-ProofDeselect_hiddeninput` | ja | ja | ja | – |

Zulässig sind alle Tags auf allen Templates des Bestellprozesses, jeweils innerhalb der `NL-Data`-Schleife.

Nur `NL-Name()` und `NL-ID()` werten einen Parameter aus. Bei den übrigen Tags prüft die Klammerung lediglich, ob überhaupt ein Wert vorliegt.

## 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)
* Wegweiser: [Zusätzliche Checkbox zur Datenweitergabe](https://dokumentation.websale.de/v8s/weitere-funktionen-im-bestellprozess-kontext/zusaetzliche-checkbox-datenweitergabe.md)


## Related topics

- [E-NL- (Seitenzustände und Meldungen)](https://dokumentation.websale.de/v8s/referenz/tags/e-nl/seitenzustaende-und-meldungen.md)
- [E-NL- (Gutschein für die Newsletter-Anmeldung)](https://dokumentation.websale.de/v8s/referenz/tags/e-nl/gutscheine.md)
- [E-Marketing-Manager](https://dokumentation.websale.de/v8s/marketing-funktionen/e-marketing-manager.md)
- [E-NL- (Anmeldeformular)](https://dokumentation.websale.de/v8s/referenz/tags/e-nl/anmeldeformular.md)
- [Newsletter-Gutscheine](https://dokumentation.websale.de/v8s/gutscheine-anbieten/newsletter-gutscheine.md)


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