=== Consenteer — Cookie Consent (GDPR & Google Consent Mode v2) ===
Contributors: consenteer
Tags: cookie consent, gdpr, rgpd, google consent mode, cookies
Requires at least: 6.7
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

GDPR cookie consent banner, managed from your free Consenteer account: create it, paste your Site ID. Google Consent Mode v2, GPC, auto-blocking.

== Description ==

Consenteer is a cookie consent management platform (CMP): the banner, its
design, the cookie scanner and the consent records live in your Consenteer
account, and this official plugin connects your WordPress site to it without
touching your theme. **A free account is required** — the plugin alone shows
nothing.

* **2-minute setup**: create an account on my.consenteer.com, add your site,
  paste the Site ID in the plugin settings.
* **GDPR / CNIL compliance**: Refuse / Customize / Accept-all buttons with equal
  weight, consent records, permanent re-access to the choice.
* **Google Consent Mode v2** built in (ad_storage, analytics_storage… signals).
* **Global Privacy Control** honored, **auto-blocking** of third-party scripts,
  refused cookies cleanup.
* **WP Consent API** support: Site Kit by Google, WooCommerce, GTM4WP and any
  plugin built on the WordPress consent standard receive the visitor's choice.
* **Full customization** from your dashboard — formats, colors, light/dark
  theme, multi-language — with no redeploy of your site.
* **"Manage my cookies" block** and `[consenteer_preferences]` shortcode for the
  re-consent link of your footer or privacy policy.
* **Site Health checks**: WordPress tells you if the banner is active and if a
  tracking tag manages to load before the consent default.

The built-in connection check detects the usual mistakes (unknown Site ID,
undeclared domain) right from the WordPress admin, and the plugin warns you if
a second cookie consent plugin is active (two banners on the same page).

The interface ships in English and French.

== External services ==

This plugin relies on the Consenteer platform (a third-party service):

* The banner script is loaded from `https://cdn.consenteer.com` on the public
  pages of your site.
* The visitor's browser talks to `https://saas.consenteer.com` to load the
  banner configuration and record consent choices (purpose: GDPR Art. 7 proof
  of consent). IP addresses are never stored in clear text (salted hash,
  server side).
* From the WordPress admin only, the plugin calls
  `https://saas.consenteer.com` to verify your Site ID.

Provider: Consenteer — https://www.consenteer.com
Terms of service: https://consenteer.com/cgu/
Privacy policy: https://consenteer.com/confidentialite/
A Consenteer account is required (a free plan is available).

== Installation ==

1. Install and activate the plugin.
2. Create an account on https://my.consenteer.com/signup and add your site
   (the declared domain must be your WordPress domain).
3. Copy the Site ID from the Installation page of the dashboard.
4. Paste it in the Consenteer menu of your WordPress admin, tick "Show the
   consent banner", save. The connection status is displayed immediately.
5. Optional — if you use Site Kit by Google, WooCommerce or a tag manager
   plugin: click "Install and activate WP Consent API" in the Consenteer
   screen, so those plugins follow the visitor's choice too. Google Consent
   Mode itself needs nothing extra.

== Frequently Asked Questions ==

= The banner does not show up =

Check the status in the Consenteer menu of your admin. The most frequent cause: your
WordPress domain is not the one declared for this site in your Consenteer
dashboard (banners are domain-locked).

= I use a caching or performance plugin (WP Rocket, LiteSpeed Cache, Autoptimize…) =

Nothing to configure: the plugin tells them to leave the banner script alone —
no local minified copy, no "delay until interaction", and the Google Consent
Mode default stays first in the page. After updating, purge the cache of your
performance plugin once so pages are rebuilt.

= Site Kit says no compatible consent management plugin is installed =

Site Kit does not read your pages: it only recognises consent banners
registered with the "WP Consent API" plugin. Install and activate that plugin
(free, by the WordPress core team), nothing else to configure: Consenteer
registers with it and reports every choice to it, so Site Kit, WooCommerce and
other plugins act on the visitor's decision. The Google Consent Mode v2 signals
themselves do not depend on it — Consenteer pushes them directly.

= How can visitors change their choice later? =

The Consenteer floating icon allows it by default. You can also add the
"Manage my cookies" block to your footer, use the `[consenteer_preferences]`
shortcode, or give any link the CSS class `consenteer-open-prefs`.

= How do I know the banner is correctly installed? =

Go to Tools → Site Health. Two checks are added by the plugin: one for the
connection to your Consenteer account, one that reads your home page and
verifies that the Google Consent Mode default is pushed before every tracking
tag.

= Does the plugin slow my site down? =

No: a single ~50 KB script loaded with `defer` from a CDN, and no server-side
request on public pages.

== Screenshots ==

1. Admin screen: paste your Site ID, the connection check confirms everything is ready (and diagnoses unknown IDs or undeclared domains).
2. The Consenteer banner live on a site — preferences view with per-category toggles, CNIL-compliant button order.

== Changelog ==

= 1.2.1 =
* New: until a Site ID is saved, a notice in the WordPress admin reminds you
  that the plugin needs a (free) Consenteer account and links to the setup.
* Improved: the plugin description says upfront that an account is required.

= 1.2.0 =
* New: WP Consent API support. Consenteer registers as a consent management
  plugin, declares the opt-in legal basis and reports every choice per category
  (functional, preferences, statistics, marketing) through `wp_set_consent()`.
  Site Kit by Google no longer reports a missing compatible consent plugin, and
  plugins relying on `wp_has_consent()` follow the visitor's decision.
* New: a card on the Consenteer screen explains what the WP Consent API is
  for, lists the plugins on your site that use it, and installs and activates
  it in one click (WordPress.org, native installer).

= 1.1.2 =
* New: "Plugin version" card on the Consenteer screen — shows whether a newer
  version is available and lets you check right now instead of waiting for the
  twice-daily WordPress check.

= 1.1.1 =
* Fix: the banner could silently never show on sites where a performance plugin
  minifies third-party scripts (WP Rocket "Minify JavaScript"): the plugin
  served its own copy of the banner script from the site, which could not reach
  the Consenteer service. The banner script and the Consent Mode default are
  now excluded from minify, combine and delay in WP Rocket, LiteSpeed Cache,
  Autoptimize and Cloudflare Rocket Loader. Purge your cache after updating.
* Tested with WordPress 7.1.

= 1.1.0 =
* New: "Manage my cookies" block for the block editor (no shortcode needed).
* New: two Site Health checks — connection status, and a home page analysis
  verifying that no tracking tag loads before the Consent Mode default.
* New: warning when another cookie consent plugin is active, and a note when a
  Google tag plugin is detected (nothing to change, Consent Mode covers it).
* New: option to hide the banner from logged-in administrators.
* Improved: redesigned admin screen with its own top-level menu, connection
  status badge and a guided first-run setup.

= 1.0.0 =
* Initial release: snippet injection, settings screen with connection check,
  "Manage my cookies" shortcode, French translation.
