..  include:: /Includes.rst.txt

..  _introduction:

============
Introduction
============

What does it do?
================

The **Prive Consent** extension provides a TYPO3 backend module for managing
`Prive Cookie Consent <https://www.prive.eu/>`__ banner scripts. Administrators
can edit, enable, and deploy consent scripts directly from the TYPO3 backend
without needing file system access or a deployment pipeline.

The consent script and a floating cookie settings button are rendered
automatically on all frontend pages by a PSR-14 event listener -- no TypoScript
and no site set have to be configured.

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 a "save and close" option
-  **Automatic frontend rendering** -- script and cookie settings button injected
   before ``</body>`` by a PSR-14 event listener, no TypoScript required
-  **Site set** (TYPO3 13.1+) -- selectable under *Site Management > Sites*;
   optional, the banner works without it
-  **Cache flush on save** -- frontend page cache is cleared automatically after
   saving
-  **Cookie settings button** -- fixed-position floating button with SVG cookie
   icon allowing visitors to reopen the consent dialog at any time

Requirements
============

-  TYPO3 12.4 LTS or 13.4 LTS
-  PHP >= 8.1
-  A `Prive <https://www.prive.eu/>`__ account to obtain the consent JavaScript
   snippet