1. 1. Installation
2. 2. Grundkonfiguration
3. 3. Cookies prüfen
4. 4. Cookie-Behandlung
5. 5. Erweiterte Konfiguration

TypoScript condition / Symfony Expression Language

Bis TYPO3 9.x können Sie folgende TypoScript-Bedingung verwenden:

[HackShield\Hst3Cookieconsent\Condition\IsCookieAcceptedCondition = custom-cookie-indentifier-defined-in-be-record]
page.includeJSFooter {
    customScript = path-or-url/to/script.js
}
[end]

Seit TYPO3 9.4 kann die Symfony Expression Language so verwendet werden:

[isCookieAccepted('custom-cookie-indentifier-defined-in-be-record')]
page.includeJSFooter {
    customScript = path-or-url/to/script.js
}
[end]

TypoScript if function

Im Kontext von TS-Objekten können Sie eine Benutzerfunktion für die if-Bedingung verwenden:
Hinweis: Stellen Sie sicher, dass Sie ein nicht gecachedes Objekt wie COA_INT verwenden.

page.10 = COA_INT
page.10 {
    5 = TEXT
    5 {
        value = TEST
        if {
            isTrue.cObject = USER
            isTrue.cObject {
                userFunc = HackShield\Hst3Cookieconsent\UserFunc\CookieUserFunc->isCookieAccpeted
                userFunc {
                    cookieIdentifier = custom-cookie-indentifier-defined-in-be-record
                }
            }
        }
    }
}

JavaScript

Hinweis: Wenn Sie diese Funktion nicht nutzen wollen, muss die Einbindung des Cookie-Consent-Scripts (standardmäßig unter page.includeJSFooter.tx_hst3cookieconsent_pi1) vor Ihrem Condition Script erfolgen!

Innerhalb von JavaScript (ES2015/ES6) können Sie dann eine statische Hilfsmethode aufrufen, um zu prüfen, ob ein Cookie akzeptiert wird:

if (true === Hst3CookieconsentHelper.isCookieAccepted('custom-cookie-indentifier-defined-in-be-record')) {
    // run scripts here
}

// z.B. einen iFrame einfügen

<script type="text/javascript">
    // add iframe to parent node of this <script> tag
    if (true === Hst3CookieconsentHelper.isCookieAccepted('custom-cookie-indentifier-defined-in-be-record')) {
        document.currentScript.parentElement.innerHTML += '<iframe width="560" height="315" src="https://www.example.com/embed/video?id=BPRdmB9TPb" frameborder="0" allow="autoplay; encrypted-media" allowfullscreen></iframe>';
    }
</script>

Anpassungen der angezeigten Texte im Cookie-Banner

Sie können statische Texte und Beschriftungen durch Überschreiben der Standard-Sprachbezeichnungen anpassen. Dies kann im TS-Setup vorgenommen werden.

plugin.tx_hst3cookieconsent_pi1 {
        # Scheme
        #_LOCAL_LANG.default.label.key = Test
        
        # Examples
        _LOCAL_LANG.default.tx_hst3cookieconsent.headline = Headline
        _LOCAL_LANG.default.tx_hst3cookieconsent.text = The intro text
        _LOCAL_LANG.de.tx_hst3cookieconsent.text = Der Hinweis-Text
}

Darüber hinaus können Sie benutzerdefinierte Übersetzungen über XLIFF-Dateien vornehmen. Siehe https://docs.typo3.org/m/typo3/reference-coreapi/8.7/en-us/Internationalization/Translation/#custom-translations

Entfernen / Anpassen des "Cookie Popup anzeigen"-Buttons

Sie können die Schaltfläche "Cookie-Popup anzeigen" einfach mittels CSS anpassen oder ausblenden. Aus rechtlicher Sicht müssen Sie Ihren Besuchern jederzeit Zugang zu den getroffenen Cookie-Einstellungen gewähren.

Technische Information Sie könnten ein HTML-Element, z.B. einen Link, einfügen und diesem Steuerungsfunktionalität mit JavaScript geben, so dass die Cookie-Bar wieder aufgerufen wird.

document.addEventListener('DOMContentLoaded', function(event) {
    // Initialize cookie popup toggle control
    Hst3CookieconsentHelper.initConsentPopupToggle(
        document.getElementById('element-class-of-your-control')
        // or
        //document.querySelector('.element-class-of-your-control')
    );
});