=== Pantry Analytics ===
Contributors: pluginpantry
Tags: analytics
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

The GA4 tag, placed properly, with consent defaults.

== Description ==

Google Analytics 4 without a dashboard. Enter the measurement ID and the tag prints in the right place on the front end, with Google Consent Mode defaults so nothing is stored until a visitor agrees, and with the roles you choose left out of the numbers. The site's own server never talks to Google.

Pantry Analytics 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 =

* Measurement ID field with validation, and the gtag.js tag printed once in the head on front-end pages only
* Never printed in wp-admin, on the login screen, in feeds, embeds or REST responses
* Exclude logged-in roles from tracking, administrators excluded by default
* Google Consent Mode v2 defaults: analytics and advertising storage denied until consent is granted, switchable off for sites without a banner
* Listens for the consent event Pantry Consent (or any banner) dispatches and updates consent on the fly
* Option to load the tag only after the visitor's first interaction, for sites that want it off the critical path
* One status line on the settings screen saying exactly what is printed

= What it does not do =

* No dashboard, charts or reports inside WordPress
* No Google account connection and no server-side requests to Google
* No other analytics vendors
* No cookie banner (see Pantry Consent)
* No event tracking beyond what GA4 does itself

== Pro add-on ==

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

* Dashboard widget with top pages and sources from the GA4 Data API, after connecting a Google account
* Custom event helpers for forms, downloads and outbound links

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 > Analytics 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) =

* Measurement ID field with validation; the gtag.js tag prints once in the head, on front-end pages only.
* Never prints in wp-admin, on wp-login.php, in feeds, embeds or REST responses.
* Exclude logged-in roles from tracking; administrators excluded by default.
* Google Consent Mode v2 defaults (analytics and advertising storage denied until consent), switchable off.
* Listens for the `pantry-consent` event (dispatched by Pantry Consent or any other banner) and updates consent on the fly.
* Option to load the tag only after the visitor's first interaction (pointerdown, keydown, scroll, or a five-second fallback).
* One status line on the settings screen saying exactly what is printed.
