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

# Consent

> Consent-Aktionen für den Cookie-Banner: Einwilligung des Nutzers zu nicht-essenziellen Cookies und Diensten setzen oder nachträglich ändern.

In diesem Abschnitt werden die verfügbaren Aktionen im Bereich Consent beschrieben. Mit diesen Aktionen kann die Zustimmung des Nutzers zu nicht-essenziellen Cookies und Diensten gesetzt oder geändert werden.

***

## Aktionen im Überblick

| **Aktion**      | **Beschreibung**                                                             |
| --------------- | ---------------------------------------------------------------------------- |
| `ConsentChange` | Setzt oder ändert die Zustimmung zu nicht-essenziellen Cookies und Diensten. |

***

## Aktionen

### ConsentChange

Mit dieser Aktion wird die Zustimmung des Nutzers zu nicht-essenziellen Cookies gesetzt oder geändert. Die Zustimmung kann auf oberster Ebene (gesamtes Consent-Objekt), auf Gruppenebene oder auf Ebene einzelner Dienste innerhalb einer Gruppe gesteuert werden.

**Anwendungsbeispiel**\
Nutzbar, um z.B. in einem Cookie-Banner dem Nutzer die Möglichkeit zu geben, seine Zustimmung für alle Cookies auf einmal, für bestimmte Gruppen (z.B. “Marketing”, “Statistik”) oder für einzelne Dienste (z.B. “Google Analytics”) gezielt zu erteilen oder zu widerrufen.

**Parameter**

| **Parameter**                               | **Beschreibung**                                                                                                                     |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `consent`                                   | Setzt die Zustimmung auf oberster Ebene für alle nicht-essenziellen Cookies.                                                         |
| `groups.<groupName>`                        | Setzt die Zustimmung für eine bestimmte Consent-Gruppe. `<groupName>` steht für den Namen der jeweiligen Gruppe.                     |
| `groups.<groupName>.services.<serviceName>` | Setzt die Zustimmung für einen einzelnen Dienst innerhalb einer Gruppe. `<serviceName>` steht für den Namen des jeweiligen Dienstes. |

**Fehlercodes**

| **Fehlercode**   | **Beschreibung**                                         |
| ---------------- | -------------------------------------------------------- |
| `invalidGroup`   | Die angegebene Gruppe existiert nicht oder ist ungültig. |
| `invalidService` | Der angegebene Dienst existiert nicht oder ist ungültig. |

**Zugehörige Module, Variablen & Methoden**

* [\$wsConsent](/frontend/referenz/module/wsconsent)
* [\$wsConsent.groups](/frontend/referenz/module/wsconsent#\$wsconsent-groups)
* [\$wsConsent.services](/frontend/referenz/module/wsconsent#\$wsconsent-services)

**Beispiel** das zeigt, wie in einem Cookie-Banner die Zustimmung pro Gruppe und pro Dienst über Checkboxen gesteuert wird.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ var $myActionConsentChange = $wsActions.create("ConsentChange") }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionConsentChange.csrf }}">
    <input type="hidden" name="wsact" value="{{= $myActionConsentChange.id }}">
    {{ foreach $myConsentGroup in $wsConsent.groups }}
        <input type="checkbox" name="groups.{{= $myConsentGroup.name }}.consent"{{ if $myConsentGroup.allowed }} checked{{ /if }}>
        {{ foreach $myConsentService in $myConsentGroup.services }}
            <input type="checkbox" name="groups.{{= $myConsentGroup.name }}.services.{{= $myConsentService.name }}"{{ if $myConsentService.allowed }} checked{{ /if }}>
        {{ /foreach }}
    {{ /foreach }}
    <button type="submit">Änderungen speichern.</button>
</form>
```


## Related topics

- [Glossar: Fachbegriffe der WEBSALE-Dokumentation](/glossar.md)
- [$wsConsent - Cookies & Services](/frontend/referenz/module/wsconsent.md)
- [actions - Sicherheit & Datenschutz](/konfiguration/actions-fehlertexte-e-mails/actions-sicherheit-datenschutz.md)
- [general - Allgemeine Shopeinstellungen](/konfiguration/general-allgemeine-shopeinstellungen.md)
- [Storefront API Konfigurationen](/schnittstellen/storefront-api/storefront-api-konfigurationen.md)