E-NL- (Managing the subscription) - WEBSALE Dokumentation

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.

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

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

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

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.

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.

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.

{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

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

<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~">

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

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

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.

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.

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

​Is the visitor a recipient at all?

​Selecting target groups

​Only for specific subshops

​Changing the status

​The delivery pause

​The blacklist

​The tags at a glance

​Related topics

Is the visitor a recipient at all?

Selecting target groups

Only for specific subshops

Changing the status

The delivery pause

The blacklist

The tags at a glance

Related topics