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
• $wsConsent.groups
• $wsConsent.services

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

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