=== OtterFixer AI Bot Tracker ===
Contributors: otterfixer195725
Tags: ai, bot, crawler, logging, diagnostics
Requires at least: 6.0
Tested up to: 6.9.1
Requires PHP: 7.4
Stable tag: 1.0.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight plugin that logs visits from common AI/LLM crawler user-agents and shows a simple report in wp-admin.

== Description ==

OtterFixer AI Bot Tracker logs front-end requests that match common AI/LLM crawler user-agents such as:
- GPTBot
- ChatGPT-User
- ClaudeBot
- PerplexityBot
- Google-Extended

It is designed to be simple and honest:
- No ads
- No bloat
- No tracking of real visitors

Important: The plugin only logs requests that match known bot user-agent patterns. If a real visitor spoofs a bot user-agent, they could be logged as well.

What is stored:
- UTC time
- Bot name
- Page path
- Anonymised IP (IPv4 last octet is zeroed, IPv6 is shortened)
- Full user-agent string

Nothing is sent anywhere. Data stays in your WordPress database.

Where to find it:
Tools → OtterFixer AI Bot Tracker

== Installation ==

1. Upload the plugin ZIP (Plugins → Add New → Upload Plugin)
2. Activate
3. Go to Tools → OtterFixer AI Bot Tracker

== Usage ==

1. Visit Tools → AI Bot Tracker.
2. Leave it running and check back whenever you want.
3. When AI bots visit your site, you will see totals, a breakdown by bot, and the most recent hits.

Tip: If you have zero hits, it usually just means no matching crawler has visited yet.

== How can I test it? ==

You can simulate a bot hit by loading any front-end URL with a matching user-agent.

Example (replace YOUR-SITE-URL with your home page URL):

curl -A "GPTBot" "YOUR-SITE-URL"

== Frequently Asked Questions ==

= Does it send data anywhere? =
No.

= Does it change my site? =
No. It only logs matching requests.

= Does it block bots? =
No. It is a tracker only.

= Where is the report? =
WP Admin → Tools → AI Bot Tracker

== Changelog ==
= 1.0.5 =
* Added clearer on-screen instructions and improved plugin action links.
* Anonymised stored IP addresses for privacy.

= 1.0.4 =
* Prefixes updated for WordPress.org review.

= 1.0.3 =
* Maintenance: Disable optional debug admin notice hook to comply with admin notice scope guidelines.
= 1.0.1 =
* Fix: resolve a PHP parse error and ensure admin "Get Help" link renders correctly.

= 1.0.0 =
* Initial release.