=== Readable – AI Agent Analytics ===
Contributors: tryreadable
Tags: ai analytics, ai agents, chatgpt, perplexity, analytics
Requires at least: 6.2
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Privacy-safe analytics for visits from AI agents and people arriving from supported AI assistants.

== Description ==

Readable – AI Agent Analytics helps website teams understand how AI systems access their WordPress content and which visits arrive from supported AI assistants.

The plugin recognizes supported AI agent signatures and supported AI referral hosts. Matching completed requests are placed in a durable local queue and sent to Readable in the background. Your visitor response does not wait for Readable.

= What the plugin sends =

For matching visits only, the plugin sends:

* The configured Readable Site ID.
* HTTPS hostname and path, without query strings or fragments.
* A recognized AI agent user agent, or a fixed generic value for an AI-referred person.
* A normalized AI referral source, never the raw referral URL.
* Request time, response status, content type, duration, and random event identity.

The plugin does not send IP addresses, cookies, request or response bodies, authorization values, arbitrary headers, raw query strings, raw referral URLs, or full browser user agents for AI-referred people.

= External service =

This plugin sends the limited analytics data described above to Readable's ingestion service at `https://ingest.sonicadn.com/v1.0/traffic/data/wordpress`. This service is required for the plugin's analytics functionality. Data is sent when a valid Readable Site ID and WordPress analytics key have been configured by a site administrator.

Readable privacy policy: https://www.tryreadable.ai/privacy

Readable terms: https://www.tryreadable.ai/terms

Product and setup information: https://www.tryreadable.ai/integrations/wordpress

== Installation ==

1. Install and activate **Readable – AI Agent Analytics**.
2. In WordPress, open **Settings → Readable Agent Analytics**.
3. Enter the Site ID and WordPress analytics key supplied by Readable.
4. Save the connection. Matching visits are queued locally and delivered in the background.

Your WordPress Address must use HTTPS, and its exact hostname must be enabled for analytics in Readable.

== Frequently Asked Questions ==

= Does this slow down my website? =

Readable is never called while generating the visitor's page response. Matching completed requests are first written to a local WordPress database queue. WP-Cron sends bounded batches later.

= Does it collect every visitor? =

No. The plugin queues only recognized AI agents and visits whose referrer hostname belongs to a supported AI assistant.

= Does it collect personal data? =

The plugin is designed to exclude IP addresses, cookies, bodies, query strings, raw referral URLs, and browser fingerprints for referred people. Site owners remain responsible for describing their use of analytics in their own privacy notice where required.

= What happens when Readable is unavailable? =

Events remain in the local queue and are retried with bounded exponential backoff. Rejected events are moved aside so they cannot block newer traffic.

= How do I get a Site ID and key? =

Visit https://www.tryreadable.ai/integrations/wordpress or contact the Readable team. Each key is bound to one active Readable WordPress integration and one site.

== Changelog ==

= 1.0.0 =

* Initial public release.
* Durable, asynchronous delivery to Readable's dedicated WordPress ingestion edge.
* Privacy-safe AI agent and AI referral classification.
* Exact acknowledgement validation, retry backoff, and rejected-event quarantine.
