Metadata-Version: 2.4
Name: plone_cookiesregtech
Version: 1.0.0
Summary: CookiesRegTech cookie consent for Plone: one-click connect, automatic banner injection, cookie scanner and consent log.
Home-page: https://www.cookiesregtech.com
Author: CookiesRegTech
Project-URL: Homepage, https://www.cookiesregtech.com
Project-URL: Privacy Policy, https://www.cookiesregtech.com/privacy-policy
Keywords: Plone cookie consent GDPR CCPA banner Google Consent Mode
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: Addon
Classifier: Framework :: Plone :: 6.0
Classifier: Framework :: Plone :: 6.1
Classifier: Framework :: Plone :: 6.2
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: Products.CMFPlone>=6.0
Requires-Dist: plone.api
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

## Plone CookiesRegTech

CookiesRegTech shows an accessible cookie consent banner on the website, blocks known trackers until the visitor agrees, signals Google Consent Mode before analytics run, and keeps a consent log that can be exported as proof.

This add-on connects the Plone site to a CookiesRegTech account and installs the consent script in the correct position (before analytics and tag managers) automatically — the step most manual installations get wrong.

**Free plan included.** A free account gives a working banner, consent logging, manual cookie scans, layout and color customisation, and 5,000 recorded pageviews per month. Paid plans add scheduled full-site scans, geo-targeted banners, custom CSS, and higher limits — upgrades happen in the CookiesRegTech dashboard, never inside this add-on.

**Features**

* One-click connect: enter an email on the settings page — a free account is created and the banner goes live, no copy-pasting required
* Opt-in (GDPR-style) and opt-out (US-style) consent templates, with geo-targeting on paid plans
* Automatic blocking of known advertising and analytics trackers until consent
* Google Consent Mode v2 signals set before Google tags execute
* Cookie scanner that discovers and categorises the cookies the site sets, with the detected list shown right on the settings page
* Signed-in jumps from Plone Site Setup straight into the consent dashboard
* Consent log with export, as required for GDPR accountability
* Accessible by design: WCAG 2.2 AA contrast, keyboard support, 44px targets

## Installation

1. Add the package to your Plone buildout or environment.

   With pip:

   ```
   pip install plone_cookiesregtech
   ```

   With buildout, add it to the `eggs` of your instance and re-run buildout:

   ```ini
   [buildout]
   eggs =
       plone_cookiesregtech
   ```

   ```
   bin/buildout
   ```

2. Load the package ZCML (only needed on older Plone versions without z3c.autoinclude):

   ```ini
   [instance]
   zcml =
       plone_cookiesregtech
   ```

3. Restart Plone, then go to **Site Setup → Add-ons** and activate **CookiesRegTech**. This registers the settings, adds the "CookiesRegTech" entry under Site Setup, and places the consent script first in the page `<head>`.
4. Open **Site Setup → CookiesRegTech**, enter an account email, accept the terms, and click "Connect website".
5. New email: a free account is created instantly and the banner is live. Existing account: click the confirmation link that arrives by email, then press "Check status".
6. Use "Open dashboard" on the settings page to customise the banner, run cookie scans, and view the consent log.

To remove the add-on, deactivate it under **Site Setup → Add-ons** (the "CookiesRegTech (uninstall)" profile is applied automatically).

## Frequently Asked Questions

### Is a CookiesRegTech account required?

Yes — a free account, created directly from the settings page. The banner configuration, cookie scanning, and consent log live in the dashboard at www.cookiesregtech.com.

### Does the add-on slow the site down?

No. It adds a single ~1KB loader script that never blocks page rendering; the banner itself loads asynchronously.

### The analytics code is pasted directly into the main template's head — is it still blocked?

The add-on registers its script as the first viewlet in Plone's `plone.htmlhead` viewlet manager, so it is rendered at the very top of the `<head>` of every site page and runs before any analytics or tag manager code placed after it. Google tags are additionally governed by Consent Mode either way.

### Where are the banner text, colors, or languages changed?

In the CookiesRegTech dashboard — changes publish to the site instantly, no add-on update needed.

### What data does the add-on send?

On connect: the account email and the site hostname, to create/link the account. Afterwards the settings page reads the connection status and detected cookie list from the CookiesRegTech API. Visitor consent choices are recorded by the banner script per the CookiesRegTech privacy policy (https://www.cookiesregtech.com/privacy-policy).
