=== ConsentX ===
Contributors: consentxio
Tags: cookie consent, consent management, cookie banner, GDPR, DPDPA
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

ConsentX is a consent management platform for WordPress with cookie consent, Google Consent Mode v2, and pre-consent script blocking.

== Description ==

ConsentX brings centralized consent management to WordPress with a fully managed cookie consent banner and privacy controls.

Connect your WordPress website to your ConsentX account and manage your consent experience from the ConsentX dashboard without manually configuring the banner on your website.

ConsentX helps websites provide visitors with clear privacy choices while giving website owners centralized control over consent categories, cookies, trackers, regional rules, consent records, DSAR workflows, and compliance reporting.

Key capabilities include:

* **1-click connection.** Connect your WordPress website to your ConsentX account and automatically register your domain so the consent banner can go live.
* **Cookie consent banner.** Display a managed cookie consent experience and allow visitors to make privacy choices.
* **Google Consent Mode v2.** Consent signals are set to denied by default and updated according to the visitor's consent choices.
* **Pre-consent script blocking.** Configured non-essential trackers can be blocked before the required consent is provided.
* **Geo-aware consent.** Adapt the consent experience according to the visitor's region and your ConsentX configuration.
* **Centralized management.** Manage banner copy, consent categories, cookies, DSAR workflows, and compliance reports from the ConsentX dashboard.
* **Consent records.** Record visitor consent choices as consent receipts to maintain an auditable record of consent.
* **Manual site-key setup.** Use a ConsentX site key when you prefer manual configuration instead of 1-click connection.

ConsentX is designed to help organizations manage consent requirements across privacy frameworks including GDPR, CCPA, LGPD, and DPDPA.

The plugin loads a lightweight ConsentX script from the ConsentX service. Banner content and consent configuration are retrieved at runtime and cached at the edge.

== Why ConsentX? ==

Traditional cookie banners can provide a basic way for visitors to accept or reject cookies, but modern privacy requirements often require more than simply displaying a banner.

ConsentX combines consent management, consent enforcement, regional configuration, Google Consent Mode v2, and consent records in one platform.

With ConsentX, website owners can:

* Manage consent from a centralized dashboard
* Give visitors control over privacy preferences
* Configure consent categories and cookies
* Help prevent configured non-essential trackers from running before consent
* Apply region-specific consent configurations
* Support Google Consent Mode v2
* Maintain consent receipts
* Manage DSAR workflows
* Access compliance reporting

== Key Features ==

= Cookie Consent Management =

ConsentX provides a fully managed cookie consent banner for WordPress websites.

Visitors can make choices according to the consent categories configured in the ConsentX dashboard.

= Google Consent Mode v2 =

ConsentX supports Google Consent Mode v2.

Consent signals are set to denied by default and updated automatically when a visitor makes a consent choice.

= Pre-Consent Script Blocking =

ConsentX helps prevent configured non-essential trackers and scripts from running before the required consent is provided.

The ConsentX widget can block known trackers client-side, while website owners can optionally gate their own enqueued scripts.

= Geo-Aware Consent =

ConsentX can adapt the consent experience according to the visitor's region.

Regional behavior is controlled through your ConsentX configuration and can support privacy requirements such as GDPR, CCPA, LGPD, and DPDPA.

= Consent Categories & Cookies =

Manage consent categories and cookies from the ConsentX dashboard instead of manually maintaining consent configuration inside WordPress.

= Consent Receipts =

ConsentX records visitor consent choices as consent receipts, helping organizations maintain an auditable record of consent.

= DSAR Management =

ConsentX provides DSAR workflows through the ConsentX dashboard so organizations can manage Data Subject Access Requests as part of their privacy workflow.

= Compliance Reporting =

ConsentX provides compliance reporting through the ConsentX dashboard, allowing organizations to review their consent and compliance information from one centralized location.

= 1-Click Connection =

Connect your WordPress website to ConsentX from the plugin settings.

Once connected, your website domain can be registered automatically and the ConsentX banner can be enabled without manually copying code.

= Manual Site-Key Setup =

If you prefer manual configuration, you can enter your ConsentX site key under Settings → ConsentX and add your domain to the corresponding ConsentX property.

== Privacy & Compliance ==

ConsentX helps websites manage consent and privacy preferences across multiple privacy frameworks.

Supported privacy frameworks include:

* GDPR
* CCPA
* LGPD
* DPDPA

Regional consent behavior is controlled through your ConsentX configuration.

== DPDPA Consent Management ==

ConsentX supports DPDPA-focused consent management for websites operating in India.

The ConsentX platform can apply DPDPA-related regional consent configuration and maintain consent receipts for visitor choices.

== How ConsentX Works ==

= 1. Install the Plugin =

Install and activate ConsentX on your WordPress website.

= 2. Connect Your Website =

Go to Settings → ConsentX and click "Connect to ConsentX".

= 3. Authorize ConsentX =

Approve the connection in your ConsentX account.

Your website domain can then be registered with the corresponding ConsentX property.

= 4. Configure Consent =

Configure your banner, consent categories, cookies, regional settings, and other consent options from the ConsentX dashboard.

= 5. ConsentX Loads on Your Website =

The plugin loads the ConsentX widget on your website.

The widget renders the consent experience using your ConsentX configuration.

= 6. Record Consent =

When visitors make a consent choice, ConsentX records the choice as a consent receipt.

== Installation ==

1. Install ConsentX from the WordPress Plugins screen or upload the plugin ZIP.
2. Activate the plugin.
3. Go to Settings → ConsentX.
4. Click "Connect to ConsentX".
5. Sign in to your ConsentX account or create an account.
6. Approve the connection.
7. Configure your consent experience from the ConsentX dashboard.

The consent banner will then be available on your WordPress website.

== Manual Setup ==

If you prefer not to use 1-click connection:

1. Install and activate ConsentX.
2. Go to Settings → ConsentX.
3. Enter your ConsentX site key.
4. Add your website domain to the corresponding property in the ConsentX dashboard.
5. Save your settings.

== Frequently Asked Questions ==

= What is ConsentX? =

ConsentX is a Consent Management Platform (CMP) for WordPress that helps websites manage cookie consent, privacy preferences, Google Consent Mode v2, pre-consent script blocking, regional consent configuration, and consent records.

= Is ConsentX only a cookie banner? =

No. ConsentX combines cookie consent management with Google Consent Mode v2, pre-consent script blocking, geo-aware consent configuration, consent receipts, DSAR workflows, and compliance reporting.

= Do I need a ConsentX account? =

Yes. The WordPress plugin connects to the ConsentX hosted service and requires a ConsentX account.

= How do I connect WordPress to ConsentX? =

Go to Settings → ConsentX and click "Connect to ConsentX". Sign in to your ConsentX account and approve the connection.

= Can I configure ConsentX without 1-click connection? =

Yes. You can use the manual site-key setup by entering your ConsentX site key under Settings → ConsentX.

= Does ConsentX support Google Consent Mode v2? =

Yes. ConsentX supports Google Consent Mode v2. Consent signals are set to denied by default and updated according to visitor consent choices.

= Can ConsentX block trackers before consent? =

Yes. ConsentX provides pre-consent script blocking for configured non-essential trackers and scripts.

= Can ConsentX change the consent experience based on region? =

Yes. ConsentX provides geo-aware consent functionality based on the visitor's region and your ConsentX configuration.

= Does ConsentX support GDPR? =

Yes. ConsentX supports GDPR-related consent management.

= Does ConsentX support CCPA? =

Yes. ConsentX supports CCPA-related consent management.

= Does ConsentX support DPDPA? =

Yes. ConsentX supports DPDPA-focused consent management and regional configuration.

= Does ConsentX support LGPD? =

Yes. ConsentX supports LGPD-related consent management.

= Where do I manage my cookie banner? =

ConsentX banner settings, consent categories, cookies, and other consent configuration are managed from the ConsentX dashboard.

= Where are consent records stored? =

Visitor consent choices are recorded by the ConsentX hosted service as consent receipts.

= Does ConsentX provide DSAR management? =

Yes. ConsentX provides DSAR workflows through the ConsentX dashboard.

= Does ConsentX provide compliance reporting? =

Yes. Compliance reporting is available through the ConsentX dashboard.

== Screenshots ==

1. ConsentX WordPress settings screen with 1-click connection and consent configuration.
2. ConsentX connected state showing the website connection and site key.
3. ConsentX cookie consent banner displayed on a live WordPress website.
4. ConsentX manual site-key setup screen.
5. ConsentX dashboard for managing consent settings.
6. ConsentX consent categories and cookie management.
7. ConsentX consent records and compliance reporting.
8. ConsentX regional consent configuration.

== External Services ==

This plugin connects your WordPress website to ConsentX, a hosted consent-management service, to display and manage the cookie consent experience.

A ConsentX account is required for the plugin to function.

When you click "Connect to ConsentX", your website domain and site name are sent to the ConsentX service so a consent property can be created for your website and the banner can be authorized to load on your domain.

On each page view, the plugin loads the ConsentX widget script from the ConsentX service. The widget renders the banner using your ConsentX dashboard configuration and records visitor consent choices as consent receipts.

ConsentX service:
https://consentx.io

Terms of Service:
https://consentx.io/terms

Privacy Policy:
https://consentx.io/privacy

Cookie Policy:
https://consentx.io/cookie-policy

== Privacy ==

ConsentX processes information required to provide consent management functionality, including website information and visitor consent choices.

For more information about how ConsentX processes data, please review:

Privacy Policy:
https://consentx.io/privacy

Cookie Policy:
https://consentx.io/cookie-policy

== Support ==

For product information and support, visit:

https://www.consentx.io/

== Changelog ==

= 1.0.2 =
* Fix: the connect callback URL is now built with a raw nonce. wp_nonce_url() HTML-encoded the ampersand (&amp;), which corrupted the _wpnonce parameter on the return trip and failed the security check.

= 1.0.1 =
* Fix: the "Connect to ConsentX" button now reaches the authorize screen. The off-site redirect host is allowlisted (it was being dropped by wp_safe_redirect) and the callback URL is no longer double-encoded.

= 1.0.0 =
* Initial release: 1-click connect, Google Consent Mode v2 defaults, optional pre-consent script blocking, and manual site-key fallback.