=== EdgeShaping Lite ===
Contributors: mareinterno
Tags: ai, bot, crawler, analytics, edgeshaping
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.3.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Observe which AI bots visit which pages and when. WordPress implementation of the EdgeShaping framework.

== Description ==

**EdgeShaping Lite** is a WordPress implementation of the EdgeShaping AI bot observation framework developed by [mare interno](https://mareinterno.com).

This plugin answers one question:

> **Which AI bots are reading which pages of your site, and when?**

= What it does =

* Detects AI bot visits using a dictionary of known AI crawlers
* Records bot name, visited URL, and timestamp
* Dashboard with bot visit frequency ranking and most AI-visited pages
* Full access log with date filter and CSV export
* AHQG Matrix — visualizes AI bot visits vs. human search clicks (requires Google Search Console integration)

= What it does NOT do =

* It does not block AI bots
* It does not modify your content
* It does not send data externally — all data stays in your WordPress database

= Note on CDN environments =

This plugin observes AI bot traffic at the PHP layer. In environments with a CDN (e.g. Cloudflare, CloudFront), cached requests may not reach PHP and will not be recorded. For full CDN-layer observation, see [mare interno](https://mareinterno.com).

= EdgeShaping Framework =

EdgeShaping is a framework for observing AI bot behavior to understand how AI systems read and interpret your content. For more information, visit [mareinterno.com](https://mareinterno.com).

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/edgeshaping-lite/` or install via the WordPress plugin screen
2. Activate the plugin through the Plugins menu in WordPress
3. Navigate to **EdgeShaping Lite** in the admin menu to view your dashboard

Data collection begins immediately after activation.

== Frequently Asked Questions ==

= Does this plugin slow down my site? =

The plugin adds a lightweight database write on each request matched to an AI bot. Non-bot traffic is not logged and has zero performance impact.

= How often is the bot dictionary updated? =

The dictionary is updated via plugin updates.

= Can I export the data? =

Yes. CSV export is available from the access log screen with date filter applied.

= What about GDPR? =

The plugin records only bot traffic (non-human). No personal data is collected.

= What is the AHQG Matrix? =

AHQG Matrix is a framework that classifies pages into four quadrants based on AI bot visits and human search clicks. Requires Google Search Console integration.

== Screenshots ==

1. Dashboard — bot frequency and page ranking
2. Access log — full observation log with date filter and CSV export
3. AHQG Matrix — AI vs. human traffic visualization


== External Services ==

This plugin connects to the following external services:

= Google Search Console API =

This plugin optionally connects to the Google Search Console API to retrieve human search click data for use in the AHQG Matrix feature.

* What it is used for: Retrieving search analytics data (clicks per page) to compare with AI bot traffic.
* What data is sent: The plugin sends OAuth 2.0 authentication requests and search analytics queries to Google's API. No personal user data from your site visitors is transmitted.
* When it is used: Only when the administrator manually connects their Google Search Console account via the plugin settings screen.
* Service provider: Google LLC
* Terms of Service: https://developers.google.com/terms
* Privacy Policy: https://policies.google.com/privacy

== Changelog ==

= 1.3.4 =
* Bug fixes (i18n: missing translators comments, escaping, placeholder ordering)

= 1.3.3 =
* Bug fixes (internationalization: hardcoded strings wrapped in translation functions)

= 1.3.2 =
* Bug fixes (upsell links for paid edition, plugin URL correction)

= 1.3.1 =
* Bug fixes (plugin installation path correction, broken documentation link fix)

= 1.3.0 =
* Added Inferred Path detection (AI-visited URLs not in sitemap)
* Added Dark Pages detection (sitemap URLs with no AI or human traffic)
* Added sitemap fetching via robots.txt directive
* Added /category/, /tag/, /author/ to default exclude paths

= 1.2.0 =
* Added AHQG Matrix with Google Search Console integration
* Added date filter (7 days, 30 days, this month, last month, custom)
* Added CSV export
* Added settings screen for GSC OAuth connection
* Added automatic data cleanup (retention period and row limit)
* Updated bot dictionary to 2026.05 version
* Added path exclusion filter (robots.txt, sitemap, wp-, feed)

= 1.1.0 =
* Added data retention settings (120 days default)
* Added rolling row limit (10,000 rows default)
* Added date filter to dashboard and log

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.2.0 =
Major update: AHQG Matrix, GSC integration, CSV export, and bot dictionary update.
