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

# $wsNewsletter - Newsletter

> Modul $wsNewsletter: Zielgruppen laden, Anmeldeformulare aufbauen, Newsletter im Kundenkonto verwalten und Abmelde-Links in E-Mails bereitstellen.

Mit dem `$wsNewsletter` Modul können Sie auf Newsletter-Funktionen zugreifen. Typische Anwendungsfälle sind Anmeldeformulare mit Zielgruppen-Auswahl, Newsletter-Verwaltung im Kundenkonto oder Abmelde-Links in E-Mails. In diesem Abschnitt erfahren Sie, wie Sie Zielgruppen laden und Newsletter-Formulare erstellen können.

***

## Modulübersicht

**Beispiel / Ausschnitt über** `$wsNewsletter`

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{= $wsNewsletter | json }}
```

**JSON-Ausgabe**

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "getTargetGroups": "ƒ()"
}
```

Anmerkung: `ƒ()` kennzeichnet eine Funktion.

**Methoden in der Übersicht**

| **Methode**         | **Rückgabe-Typ** | **Beschreibung**                             |
| ------------------- | ---------------- | -------------------------------------------- |
| `getTargetGroups()` | array            | Lädt die verfügbaren Newsletter-Zielgruppen. |

***

## Templates

Newsletter-Formulare werden typischerweise an folgenden Stellen eingesetzt:

* Footer: Kompaktes Anmeldeformular mit E-Mail-Feld.
* Eigene Seite: Ausführliches Formular mit Zielgruppen-Auswahl und zusätzlichen Feldern.
* Kundenkonto: Verwaltung der Newsletter-Abonnements.

***

## Variablen

Für `$wsNewsletter` stehen keine Variablen zur Verfügung.

***

## Methoden

### \$wsNewsletter.getTargetGroups()

Lädt die verfügbaren Newsletter-Zielgruppen.

**Signatur**\
`$wsNewsletter.getTargetGroups()`

**Rückgabe**\
`array` - Liste der verfügbaren Zielgruppen.

**Beispiel,** das alle Zielgruppen lädt.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ var $myTargetGroups = $wsNewsletter.getTargetGroups() }}
{{ foreach $targetGroup in $myTargetGroups }}
    {{= $targetGroup.name }} - {{= $targetGroup.id }}
{{ /foreach }}
```

***

## Aktionen

Für `$wsNewsletter` stehen keine Aktionen zur Verfügung.

***

## Beispiele

### Anmeldeformular mit Zielgruppen-Auswahl

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ var $targetGroups = $wsNewsletter.getTargetGroups() }}

{{ if $targetGroups }}
  <p>Newsletter auswählen:</p>
  {{ foreach $group in $targetGroups }}
    <label>
      <input type="checkbox" name="targetGroupId" value="{{= $group.id }}">
      {{= $group.name }}
    </label>
  {{ /foreach }}
{{ /if }}
```

***

## Weiterführende Links

* [newsletter - Newsletter](/konfiguration/newsletter-newsletter)
* [actions - Newsletter](/konfiguration/actions-fehlertexte-e-mails/actions-newsletter)