=== Pantry Consent ===
Contributors: pluginpantry
Tags: consent
Requires at least: 6.4
Tested up to: 7.1
Stable tag: 1.0.0
Requires PHP: 8.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A cookie banner with categories that holds tags until consent.

== Description ==

A plain consent bar with accept, reject and a choice of categories. Scripts marked for a category stay inert until the visitor allows it, Google Consent Mode is updated for tags that use it, and the choice is remembered in a first-party cookie. Nothing is logged and nothing is sent anywhere.

Pantry Consent is built to the Pantry Standard, a public document that fixes what every Plugin Pantry plugin may and may not do: https://thepluginpantry.com/standard

= What it does =

* A bar at the bottom of the page with headline, text, a link to the privacy page, and three buttons: accept all, reject non-essential, save choices
* Categories necessary, analytics, marketing and preferences, each switchable on the settings screen
* Scripts marked with type text/plain and a data-pantry-consent category attribute run only once that category is allowed
* Dispatches a pantry-consent event with the allowed categories on every page load and on every change, for other plugins and tags
* Updates Google Consent Mode v2 when gtag is present
* Remembers the choice for six months in a first-party cookie and offers a Cookie settings link via shortcode, block or footer option to change it
* Keyboard accessible, inline CSS with colour settings, no external requests

= What it does not do =

* No consent log or proof of consent
* No region or country detection
* No automatic cookie or script scanner
* No blocking of scripts that are not marked for a category
* No multi-language texts beyond the ones you enter

== Pro add-on ==

A separate Pantry Pro add-on is planned. It will extend this plugin with:

* Consent log for audits with export
* Per-script and per-plugin blocking rules without editing markup
* Region-based defaults

Nothing in this free plugin is locked or limited. It is complete for its scope.

== Installation ==

1. Upload the plugin folder to /wp-content/plugins/ or install it from the Plugins screen.
2. Activate it.
3. Open Plugin Pantry > Consent and set it up.

== Frequently Asked Questions ==

= Does the free plugin expire or nag? =

No. It keeps working forever and never shows a sales notice.

= Does it send any data anywhere? =

Only what the feature itself requires, and that is listed on the plugin page.

= Where do I report a bug? =

https://thepluginpantry.com/support

== Changelog ==

= 1.0.0 (2026-09-12) =

* A consent bar at the bottom of the page with a headline, a message, a privacy
* Categories necessary, analytics, marketing and preferences, each offered or
* Scripts marked `type="text/plain"` and `data-pantry-consent="<category>"` are
* A `pantry-consent` event on `document` on every page load and every change,
* `gtag( 'consent', 'update', ... )` for Consent Mode v2 when a tag has put
* The choice kept for 180 days in one first-party cookie, stamped with a
* A Cookie settings link that brings the bar back, as the shortcode
* Colour settings and about a kilobyte of CSS printed with the bar. No
* Filters `pantry_consent_categories`, `pantry_consent_show_bar` and
