> ## 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- (Managing the subscription)

> Select target groups, pause the newsletter, unsubscribe or add yourself to the blacklist: the tags for the management page of the E-Marketing Manager.

A subscriber has more choices than on or off. They can select individual target groups, suspend delivery for a while, or unsubscribe completely and have themselves added to the blacklist.

The tags on this page build the management page for this. Almost all of them belong in the `E-NL-SEC-Manage` section.

Guide: E-Marketing Manager

## Is the visitor a recipient at all?

`E-NL-Receiver` applies if the visitor is logged in and registered as a newsletter recipient. Everything that relates to an existing subscription belongs inside this range.

```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` is only evaluated within `E-NL-SEC-Manage`. In the sections for subscribing and unsubscribing, it has no effect.

## Selecting target groups

A shop can run several newsletters; in the E-Marketing Manager they are called target groups. Each has an index by which the tags address it.

| Tag | Returns |
| - | - |
| `E-NL-TargetGroup()` | as a range tag: applies if this target group exists. As a single tag: its name |
| `E-NL-TargetGroup_name()` | the field name of the checkbox |
| `E-NL-TargetGroup_checked()` | `checked` if the subscriber is registered for it |
| `E-NL-TargetGroup_hidden()` | a complete hidden field |
| `E-NL-TargetGroup_definition()` | the description of the target group stored in the manager |

```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]
>
> There is no loop over the target groups. Each one is written into the template individually with its index. If a target group is added in the manager, it must be added to the template as well.

> [!NOTE]
>
> This is why the `{E-NL-TargetGroup(n)}` range matters: it keeps the block off the page as long as no target group with this index exists. This lets you build the template in advance for more target groups than currently exist.

> [!NOTE]
>
> `E-NL-TargetGroup_hidden()` belongs next to the checkbox. Without this hidden field, the E-Marketing Manager does not learn on submission that a deselected checkbox was in the form at all, and treats the target group as unchanged.

## Only for specific subshops

`E-NL-Subshop()` shows a section depending on the subshop the visitor is currently in.

```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)}
```

## Changing the status

A subscriber has exactly one of three states: active, paused or blacklisted. In the template, this is a group of three radio buttons.

| Tag | Returns |
| - | - |
| `E-NL-Status_name` | the shared field name of the group |
| `E-NL-StatusActive_value` | the value for "active" |
| `E-NL-StatusActive_checked` | `checked` if the subscriber is active |
| `E-NL-StatusPaused_value` | the value for "paused" |
| `E-NL-StatusPaused_checked` | `checked` if the subscriber is paused |
| `E-NL-StatusBlackList_value` | the value for "blacklist" |
| `E-NL-StatusBlackList_checked` | `checked` if the subscriber is on the blacklist |
| `E-NL-Status_hidden` | a complete hidden field for the 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}
```

> [!NOTE]
>
> `E-NL-StatusActive_checked` can also be used as a range tag. This lets you show additional fields only for the currently selected state, for example the date field only for a paused subscription.

## The delivery pause

A pause raises the question of how long it lasts. Two tags provide the two possible types.

| Tag | Returns |
| - | - |
| `E-NL-PauseType_name` | the field name for the type of pause |
| `E-NL-PauseTypeDate` | the value for "until a date" |
| `E-NL-PauseTypeNoDate` | the value for "indefinitely" |
| `E-NL-Pause_name` | the field name of the end date |
| `E-NL-Pause` | the end date entered so far |
| `E-NL-Pause_hidden` | a complete hidden field for the pause |
| `E-NL-PauseTillDate_error` | the string `_error` if the date could not be read |

```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` only outputs the string `_error` and is not a range tag. You write your own error message for it in the template, for example via the CSS class.

Three further tags belong to the pause and are needed if pausing is offered as a separate checkbox instead of a radio button group.

| Tag | Returns |
| - | - |
| `E-NL-PauseNewsletter` | the value for setting the delivery pause |
| `E-NL-PauseNewsletter_name` | the field name for it |
| `E-NL-PauseNewsletter_checked` | `checked` if the subscriber is paused |

## The blacklist

Anyone on the blacklist no longer receives mail from any target group. This is more than unsubscribing, because it also prevents accidental re-subscription later.

| Tag | Returns |
| - | - |
| `E-NL-BlackList_name` | the field name of the checkbox |
| `E-NL-BlackList_checked` | `checked` if the subscriber is on the blacklist |
| `E-NL-BlackList_hidden` | a complete hidden field |

```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}
```

> [!NOTE]
>
> If the shop runs only a single target group, the difference between unsubscribing and the blacklist makes no sense to the visitor. In that case, set the blacklist permanently with `E-NL-BlackList_hidden` and do not show the checkbox at all.

> [!WARNING]
>
> The blacklist tags are only evaluated in the `E-NL-SEC-Manage` and `E-NL-SEC-Unsubscribe` sections.

## The tags at a glance

| Tag | Single tag | Range tag | Negative range tag | Loop tag |
| - | - | - | - | - |
| `E-NL-Receiver` | – | yes | yes | – |
| `E-NL-Subshop()` | – | yes | yes | – |
| `E-NL-TargetGroup()` | yes | yes | – | – |
| `E-NL-TargetGroup_name()` | yes | – | – | – |
| `E-NL-TargetGroup_checked()` | yes | – | – | – |
| `E-NL-TargetGroup_hidden()` | yes | – | – | – |
| `E-NL-TargetGroup_definition()` | yes | – | – | – |
| `E-NL-Status_name` | yes | – | – | – |
| `E-NL-Status_hidden` | yes | – | – | – |
| `E-NL-StatusActive_value` | yes | – | – | – |
| `E-NL-StatusActive_checked` | yes | yes | yes | – |
| `E-NL-StatusPaused_value` | yes | – | – | – |
| `E-NL-StatusPaused_checked` | yes | – | – | – |
| `E-NL-StatusBlackList_value` | yes | – | – | – |
| `E-NL-StatusBlackList_checked` | yes | – | – | – |
| `E-NL-Pause` | yes | – | – | – |
| `E-NL-Pause_name` | yes | – | – | – |
| `E-NL-Pause_hidden` | yes | – | – | – |
| `E-NL-PauseTillDate_error` | yes | – | – | – |
| `E-NL-PauseType_name` | yes | – | – | – |
| `E-NL-PauseTypeDate` | yes | – | – | – |
| `E-NL-PauseTypeNoDate` | yes | – | – | – |
| `E-NL-PauseNewsletter` | yes | – | – | – |
| `E-NL-PauseNewsletter_name` | yes | – | – | – |
| `E-NL-PauseNewsletter_checked` | yes | – | – | – |
| `E-NL-BlackList_name` | yes | – | – | – |
| `E-NL-BlackList_checked` | yes | – | – | – |
| `E-NL-BlackList_hidden` | yes | – | – | – |

All tags are permitted in the template entered in the shop configuration `shop.config` in the `<eMarketingManager>` section for the `Manage` parameter.

## Related topics

* Guide: E-Marketing Manager
* Materials: Materials for the E-Marketing Manager
* Reference: E-NL- (Page states and messages)
* Reference: E-NL- (Sign-up form)


## Related topics

- [E-NL- (Sign-up form)](https://dokumentation.websale.de/en/v8s/referenz/tags/e-nl/anmeldeformular.md)
- [E-NL- (Page states and messages)](https://dokumentation.websale.de/en/v8s/referenz/tags/e-nl/seitenzustaende-und-meldungen.md)
- [Materials: E-Marketing-Manager](https://dokumentation.websale.de/en/v8s/materialien/materialien-emarketing-manager.md)
- [E-NL- (Voucher for newsletter subscription)](https://dokumentation.websale.de/en/v8s/referenz/tags/e-nl/gutscheine.md)
- [SUBS- (managing subscriptions)](https://dokumentation.websale.de/en/v8s/referenz/tags/subs/abos-verwalten.md)


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