> ## 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- (Abonnement verwalten)

> Zielgruppen auswählen, den Newsletter pausieren, abbestellen oder auf die Blacklist setzen: die Tags für die Verwaltungsseite des E-Marketing-Managers.

Ein Abonnent hat mehr als die Wahl zwischen an und aus. Er kann einzelne Zielgruppen wählen, den Empfang für eine Weile ruhen lassen oder sich ganz austragen und auf die Blacklist setzen lassen.

Die Tags dieser Seite bauen die Verwaltungsseite dafür auf. Sie gehören fast alle in den Bereich `E-NL-SEC-Manage`.

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

## Ist der Besucher überhaupt Empfänger?

`E-NL-Receiver` greift, wenn der Besucher angemeldet und als Newsletter-Empfänger eingetragen ist. Alles, was sich auf ein bestehendes Abo bezieht, gehört in diese Klammer.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-NL-SEC-Manage}
   {E-NL-Receiver}
      <!-- Status ändern, pausieren, abbestellen -->
   {/E-NL-Receiver}

   {!E-NL-Receiver}
      <p>Für diese Adresse liegt kein Abonnement vor.</p>
   {/!E-NL-Receiver}
{/E-NL-SEC-Manage}
```

> [!WARNING]
>
> `E-NL-Receiver` wird nur innerhalb von `E-NL-SEC-Manage` ausgewertet. In den Bereichen für An- und Abmeldung bleibt es wirkungslos.

## Zielgruppen auswählen

Ein Shop kann mehrere Newsletter führen, im E-Marketing-Manager heißen sie Zielgruppen. Jede hat einen Index, über den die Tags sie ansprechen.

| Tag | Liefert |
| - | - |
| `E-NL-TargetGroup()` | als Bereichs-Tag: greift, wenn es diese Zielgruppe gibt. Als Einzel-Tag: ihren Namen |
| `E-NL-TargetGroup_name()` | den Feldnamen der Checkbox |
| `E-NL-TargetGroup_checked()` | `checked`, wenn der Abonnent für sie eingetragen ist |
| `E-NL-TargetGroup_hidden()` | ein vollständiges verstecktes Feld |
| `E-NL-TargetGroup_definition()` | die im Manager hinterlegte Beschreibung der Zielgruppe |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<ul class="zielgruppen">
   {E-NL-TargetGroup(1)}
      <li>
         <input type="checkbox"
                id="zg1"
                name="~E-NL-TargetGroup_name(1)~"
                value="1"
                ~E-NL-TargetGroup_checked(1)~>
         ~E-NL-TargetGroup_hidden(1)~
         <label for="zg1">~E-NL-TargetGroup(1)~</label>
         <p class="beschreibung">~E-NL-TargetGroup_definition(1)~</p>
      </li>
   {/E-NL-TargetGroup(1)}

   {E-NL-TargetGroup(2)}
      <li>
         <input type="checkbox"
                id="zg2"
                name="~E-NL-TargetGroup_name(2)~"
                value="2"
                ~E-NL-TargetGroup_checked(2)~>
         ~E-NL-TargetGroup_hidden(2)~
         <label for="zg2">~E-NL-TargetGroup(2)~</label>
      </li>
   {/E-NL-TargetGroup(2)}
</ul>
```

> [!WARNING]
>
> Es gibt keine Schleife über die Zielgruppen. Jede wird im Template einzeln mit ihrem Index hingeschrieben. Kommt im Manager eine Zielgruppe dazu, muss sie im Template ergänzt werden.

Die Klammerung `{E-NL-TargetGroup(n)}` ist deshalb wichtig: Sie hält den Block aus der Seite heraus, solange es die Zielgruppe mit diesem Index nicht gibt. So lässt sich das Template auf Vorrat für mehr Zielgruppen bauen, als derzeit angelegt sind.

`E-NL-TargetGroup_hidden()` gehört neben die Checkbox. Ohne dieses versteckte Feld erfährt der E-Marketing-Manager beim Absenden nicht, dass eine abgewählte Checkbox überhaupt im Formular stand, und behandelt die Zielgruppe als unverändert.

## Nur für bestimmte Subshops

`E-NL-Subshop()` blendet einen Bereich abhängig vom Subshop ein, in dem der Besucher gerade ist.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-NL-Subshop(English)}
   <p>Our newsletter is published in English.</p>
{/E-NL-Subshop(English)}

{!E-NL-Subshop(English)}
   <p>Unser Newsletter erscheint auf Deutsch.</p>
{/!E-NL-Subshop(English)}
```

## Den Status ändern

Ein Abonnent hat genau einen von drei Zuständen: aktiv, pausiert oder auf der Blacklist. Im Template ist das eine Gruppe aus drei Radiobuttons.

| Tag | Liefert |
| - | - |
| `E-NL-Status_name` | den gemeinsamen Feldnamen der Gruppe |
| `E-NL-StatusActive_value` | den Wert für "aktiv" |
| `E-NL-StatusActive_checked` | `checked`, wenn der Abonnent aktiv ist |
| `E-NL-StatusPaused_value` | den Wert für "pausiert" |
| `E-NL-StatusPaused_checked` | `checked`, wenn der Abonnent pausiert |
| `E-NL-StatusBlackList_value` | den Wert für "Blacklist" |
| `E-NL-StatusBlackList_checked` | `checked`, wenn der Abonnent auf der Blacklist steht |
| `E-NL-Status_hidden` | ein vollständiges verstecktes Feld für den Status |

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

      <label>
         <input type="radio"
                name="~E-NL-Status_name~"
                value="~E-NL-StatusActive_value~"
                ~E-NL-StatusActive_checked~>
         Ich möchte den Newsletter weiterhin erhalten.
      </label>

      <label>
         <input type="radio"
                name="~E-NL-Status_name~"
                value="~E-NL-StatusPaused_value~"
                ~E-NL-StatusPaused_checked~>
         Ich möchte den Newsletter vorübergehend abbestellen bis:
      </label>
      <input type="text"
             name="~E-NL-Pause_name~"
             value="~E-NL-Pause~"
             class="eingabe~E-NL-PauseTillDate_error~"
             maxlength="12"
             id="ws_nl_datepicker">
      <input type="hidden" name="~E-NL-PauseType_name~" value="~E-NL-PauseTypeDate~">

      <label>
         <input type="radio"
                name="~E-NL-Status_name~"
                value="~E-NL-StatusBlackList_value~"
                ~E-NL-StatusBlackList_checked~>
         Ich möchte mich abmelden und aus allen Versandlisten entfernt werden.
      </label>

      <button type="submit">Speichern</button>
   </fieldset>
{/E-NL-Receiver}
```

`E-NL-StatusActive_checked` lässt sich auch klammern. Damit blenden Sie zusätzliche Felder nur für den gerade gewählten Zustand ein, beispielsweise das Datumsfeld nur bei pausiertem Abo.

## Die Empfangspause

Zur Pause gehört die Frage, wie lange sie dauert. Zwei Tags liefern die beiden möglichen Arten.

| Tag | Liefert |
| - | - |
| `E-NL-PauseType_name` | den Feldnamen für die Art der Pause |
| `E-NL-PauseTypeDate` | den Wert für "bis zu einem Datum" |
| `E-NL-PauseTypeNoDate` | den Wert für "unbegrenzt" |
| `E-NL-Pause_name` | den Feldnamen des Enddatums |
| `E-NL-Pause` | das bisher eingetragene Enddatum |
| `E-NL-Pause_hidden` | ein vollständiges verstecktes Feld für die Pause |
| `E-NL-PauseTillDate_error` | die Zeichenkette `_error`, wenn das Datum nicht lesbar war |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<label>
   <input type="radio" name="~E-NL-PauseType_name~" value="~E-NL-PauseTypeNoDate~">
   bis auf Weiteres
</label>

<label>
   <input type="radio" name="~E-NL-PauseType_name~" value="~E-NL-PauseTypeDate~">
   bis zum
</label>
<input type="text"
       name="~E-NL-Pause_name~"
       value="~E-NL-Pause~"
       class="eingabe~E-NL-PauseTillDate_error~">
```

> [!WARNING]
>
> `E-NL-PauseTillDate_error` gibt nur die Zeichenkette `_error` aus und ist kein Bereichs-Tag. Eine eigene Fehlermeldung dazu formulieren Sie im Template selbst, beispielsweise über die CSS-Klasse.

Drei weitere Tags gehören zur Pause und werden gebraucht, wenn die Pausierung als eigene Checkbox statt als Radiobutton-Gruppe angeboten wird.

| Tag | Liefert |
| - | - |
| `E-NL-PauseNewsletter` | den Wert zum Setzen der Empfangspause |
| `E-NL-PauseNewsletter_name` | den Feldnamen dafür |
| `E-NL-PauseNewsletter_checked` | `checked`, wenn der Abonnent pausiert |

## Die Blacklist

Wer auf der Blacklist steht, bekommt aus keiner Zielgruppe mehr Post. Das ist mehr als eine Abmeldung, denn es verhindert auch eine spätere versehentliche Wiederaufnahme.

| Tag | Liefert |
| - | - |
| `E-NL-BlackList_name` | den Feldnamen der Checkbox |
| `E-NL-BlackList_checked` | `checked`, wenn der Abonnent auf der Blacklist steht |
| `E-NL-BlackList_hidden` | ein vollständiges verstecktes Feld |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-NL-SEC-Unsubscribe}
   <form action="~FORM-SSLTemplate(ws_emarketing_manager_newsletter.htm)~" method="post">
      <label>
         <input type="checkbox"
                name="~E-NL-BlackList_name~"
                value="blacklist"
                ~E-NL-BlackList_checked~>
         Ich möchte künftig gar keine Newsletter mehr erhalten.
      </label>

      <input type="hidden" name="logintype" value="unsubscribe">
      <button type="submit">Newsletter abbestellen</button>
   </form>
{/E-NL-SEC-Unsubscribe}
```

Führt der Shop nur eine einzige Zielgruppe, ist die Unterscheidung zwischen Abmelden und Blacklist für den Besucher nicht nachvollziehbar. Dann setzen Sie die Blacklist fest mit `E-NL-BlackList_hidden` und zeigen die Checkbox gar nicht erst.

> [!WARNING]
>
> Die Blacklist-Tags werden nur in den Bereichen `E-NL-SEC-Manage` und `E-NL-SEC-Unsubscribe` ausgewertet.

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `E-NL-Receiver` | – | ja | ja | – |
| `E-NL-Subshop()` | – | ja | ja | – |
| `E-NL-TargetGroup()` | ja | ja | – | – |
| `E-NL-TargetGroup_name()` | ja | – | – | – |
| `E-NL-TargetGroup_checked()` | ja | – | – | – |
| `E-NL-TargetGroup_hidden()` | ja | – | – | – |
| `E-NL-TargetGroup_definition()` | ja | – | – | – |
| `E-NL-Status_name` | ja | – | – | – |
| `E-NL-Status_hidden` | ja | – | – | – |
| `E-NL-StatusActive_value` | ja | – | – | – |
| `E-NL-StatusActive_checked` | ja | ja | ja | – |
| `E-NL-StatusPaused_value` | ja | – | – | – |
| `E-NL-StatusPaused_checked` | ja | – | – | – |
| `E-NL-StatusBlackList_value` | ja | – | – | – |
| `E-NL-StatusBlackList_checked` | ja | – | – | – |
| `E-NL-Pause` | ja | – | – | – |
| `E-NL-Pause_name` | ja | – | – | – |
| `E-NL-Pause_hidden` | ja | – | – | – |
| `E-NL-PauseTillDate_error` | ja | – | – | – |
| `E-NL-PauseType_name` | ja | – | – | – |
| `E-NL-PauseTypeDate` | ja | – | – | – |
| `E-NL-PauseTypeNoDate` | ja | – | – | – |
| `E-NL-PauseNewsletter` | ja | – | – | – |
| `E-NL-PauseNewsletter_name` | ja | – | – | – |
| `E-NL-PauseNewsletter_checked` | ja | – | – | – |
| `E-NL-BlackList_name` | ja | – | – | – |
| `E-NL-BlackList_checked` | ja | – | – | – |
| `E-NL-BlackList_hidden` | ja | – | – | – |

Zulässig sind alle Tags im Template, das in der Shopkonfiguration `shop.config` im Abschnitt `<eMarketingManager>` beim Parameter `Manage` eingetragen ist.

## 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- (Anmeldeformular)](https://dokumentation.websale.de/v8s/referenz/tags/e-nl/anmeldeformular.md)


## Related topics

- [E-NL- (Anmeldeformular)](https://dokumentation.websale.de/v8s/referenz/tags/e-nl/anmeldeformular.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.