README

TYPO3 backend module for managing Prive Cookie Consent banner scripts.

Features

• Backend module under Web > Prive Consent for editing consent scripts
• Enable/disable toggle to activate or deactivate the banner without removing the script
• Multi-site support -- automatically resolves the correct site root per TYPO3 site configuration
• Unsaved changes protection -- warns before navigating away with unsaved modifications (with "save and close" support)
• Automatic frontend rendering -- script and cookie settings button injected before </body> by a PSR-14 event listener (no TypoScript or template changes required)
• Cache flush on save -- frontend page cache is cleared automatically after saving
• Cookie settings button -- fixed-position floating button with SVG cookie icon for visitors to reopen consent dialog

Requirements

• TYPO3 14.3 LTS
• PHP >= 8.2 (8.2–8.5)

Installation

Composer (recommended)

composer require oliverkroener/ok-prive-consent

Extension Manager

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

No site set required

The consent banner renders automatically on every frontend page once the extension is installed -- it is injected by a PSR-14 event listener registered through the extension's Services.yaml. No site set, TypoScript, or template change is needed.

A site set named oliverkroener/ok-prive-consent is still shipped (so existing site configurations that reference it under dependencies keep working), but it is now a no-op and entirely optional.

Usage

1. Navigate to Web > Prive Consent in the TYPO3 backend
2. Select a page in the page tree (the module resolves the site root automatically)
3. Toggle Enable Prive script to activate/deactivate the banner
4. Paste the JavaScript snippet from your Prive dashboard
5. Click Save

The consent script and a cookie settings button are rendered automatically in the page footer on all frontend pages.

Configuration

The extension works out of the box once installed -- the banner is injected by the event listener with no further configuration. To customise the cookie settings button, override the styles from Resources/Public/Css/prive-cookie-button.css in your site package.

Brand colours: primary #f05722, secondary #0fa8dd.

Architecture

TYPO3 Backend --> ConsentController --> sys_template table
                       |
              ModuleTemplateFactory,
              SiteFinder, ConnectionPool
                    (TYPO3 core)

Frontend --> AfterCacheableContentIsGeneratedEvent
                  |
             InjectBannerScript (listener) --> DatabaseService --> sys_template table
                  |                                  |
          inject before </body>              SiteFinder (TYPO3 core)

Database fields (on sys_template)

The fields are declared in ext_tables.sql and read/written exclusively via QueryBuilder from the backend module (there is no TCA definition). Field names retain the original ok_prive_cookie_consent prefix for backward compatibility with existing data.

Frontend rendering order

The listener injects the markup before </body> in this order to ensure correct DOM timing:

1. CSS -- cookie button stylesheet loaded via <link> tag
2. Cookie button -- <a> element with data-cc="c-settings" attribute
3. Prive script -- the consent JavaScript snippet (so it can bind to the button already in DOM)

Injecting via a PSR-14 event listener (rather than a TypoScript page.footerData USER object) makes rendering independent of site-set load order: a theme set that re-declares page = PAGE after this extension can no longer discard the banner. The markup is part of the cacheable page content, so it is stored in the page cache.

Documentation

Full documentation is available in the Documentation/ directory. Generate rendered docs locally with:

make docs

This uses the official TYPO3 Documentation rendering container.

License

GPL-2.0-or-later

Author — Oliver Kroener

Automated. Scaled. Done.

Web3 · Cloud · Automation

Technology is only valuable when it solves a real problem. For over 30 years I've been translating between business and tech — so your investment in digitalisation doesn't stall at proof-of-concept but delivers measurable results.

• Website: oliver-kroener.de
• Web3: web3.oliver-kroener.de
• Email: ok@oliver-kroener.de
• Web3 Email: oliverkroener@ethermail.io