Installation

Install with Composer

Note

This is the recommended way to install this extension.

Install the extension via Composer:

composer req oliverkroener/ok-prive-consent

Install via Extension Manager

Download or upload the extension and activate it via Admin Tools > Extensions.

After the installation

No TypoScript needs to be included and no site set needs to be added -- the consent script and cookie button are injected by a PSR-14 event listener that is registered through the extension's Services.yaml.

Update the database

Go to Admin Tools > Maintenance > Analyze Database Structure and apply the suggested changes. This adds the two consent fields to the pages table.
Clear caches

Clear all caches so the event listener is picked up.
Optional: add the site set (TYPO3 13.1+)

In Site Management > Sites you may add the set [kroener.DIGITAL] Prive Consent. The set is empty and optional -- see Site set.

Upgrading from version 4.1.1 or older

Up to version 4.1.1 the banner settings were stored on the sys_template record of the site root. Since version 4.2.0 they live on the pages record of the site root, so that sites driven purely by site sets -- which have no sys_template record at all -- keep working.

Analyze the database structure

Admin Tools > Maintenance > Analyze Database Structure.
Run the upgrade wizard

In Admin Tools > Upgrade > Upgrade Wizard, run EXT:ok_prive_consent: Move consent banner settings from sys_template to pages. It copies the existing script and enable flag to the site root page. Running it twice is harmless.
Optional: clean up the TypoScript record

The static template [kroener.DIGITAL] Prive Consent is empty now. It is still shipped so existing includes do not break, but it can be removed from the Includes tab of your template record.