=== GoVISIBLE AI Bot Tracker ===
Contributors: govisible
Tags: ai, bot, crawler, analytics, seo
Requires at least: 5.6
Tested up to: 7.0
Stable tag: 1.0.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Track visits from AI bots like ChatGPT, GPTBot, Claude, Gemini, and Perplexity.

== Description ==

**GoVISIBLE AI Bot Tracker** helps you **detect**, **log**, and **understand** visits from AI bots, LLM crawlers, and generative search crawlers accessing your content.

As AI-powered search engines and assistants continue to crawl websites for indexing, research, and training, it's important to know when these bots visit your content. **AI Bot Tracker** automatically records every supported AI crawler request and displays detailed statistics inside your WordPress dashboard.

**GoVISIBLE AI Bot Tracker** gives you a simple way to monitor AI crawler activity directly inside WordPress. The plugin logs AI bot visits with useful details such as **bot type**, **visit date**, **IP address**, and **visited URL**, then visualizes the activity in an easy-to-use admin dashboard.

= How It Works =

**Install > Activate > Track AI Bot Visits**

Once activated, the plugin starts logging known AI bot activity in the background. You can review AI crawler visits from your WordPress admin dashboard, use date filters, view activity trends, and check which URLs are being accessed by AI bots.

**No complicated setup is required.**

= Why Track AI Bots and LLM Crawlers? =

AI-powered discovery is changing how users find information. Generative platforms such as **ChatGPT**, **Gemini**, **Perplexity**, **Claude**, **Copilot**, and AI search tools rely on web content, citations, and crawl signals to understand brands, topics, and pages.

**GoVISIBLE AI Bot Tracker** helps you answer important questions:

* Are AI bots visiting my website?
* Which pages are being accessed by AI crawlers?
* How often do AI bots visit my content?
* Which AI crawler types are appearing in my logs?
* Are my important pages being reached by generative search crawlers?
* Is my content being discovered beyond traditional search engines?

Without AI crawler data, it is difficult to understand how your website is being accessed in the new AI search landscape.

= What This Plugin Tracks =

**GoVISIBLE AI Bot Tracker** logs useful AI crawler activity, including:

* **AI bot visits**
* **Bot type**
* **Visit date**
* **IP address**
* **Visited URL**
* **Crawl activity over time**
* **Page-level AI bot activity**

This helps you see which parts of your website are being accessed by known AI crawlers and how AI bot activity changes over time.

= Core Features =

* **AI bot visit detection**
* **LLM crawler tracking**
* **AI crawler activity logs**
* **Visited URL tracking**
* **Bot type logging**
* **IP address logging**
* **Date-based activity tracking**
* **Admin dashboard inside WordPress**
* **Date filter** for reviewing crawl activity
* **Bar chart** showing AI bot activity over time
* **Table of all AI bot visits**
* **Local data storage** inside WordPress
* **No external tracking** of bot visit data
* **No third-party data collection**
* **100% GPL-compliant**

= Built for SEO and GEO =

**GoVISIBLE AI Bot Tracker** supports modern SEO workflows focused on **AI search visibility** and **Generative Engine Optimization**, also known as **GEO**.

Traditional SEO tools help you understand rankings, impressions, clicks, and backlinks. **GoVISIBLE AI Bot Tracker** adds another layer by helping you understand whether AI bots and generative search crawlers are accessing your website content.

= Who Can Use GoVISIBLE AI Bot Tracker? =

**GoVISIBLE AI Bot Tracker** is useful for:

* **Website owners** who want to monitor AI bot visits
* **SEO professionals** tracking AI crawler activity
* **Content creators** checking whether articles are accessed by AI bots
* **Publishers** monitoring AI discovery patterns
* **E-commerce websites** reviewing AI crawler access

= Actionable Insights You Can Get =

The plugin helps you understand:

* Which URLs are accessed by AI crawlers?
* How often AI bots visit your website?
* Which content receives AI bot activity?
* Whether important pages are being reached by known AI crawlers?
* How AI crawler visits change over time?
* Which bot types are appearing in your WordPress logs?

These insights can help guide **content optimization**, **technical SEO checks**, **robots.txt decisions**, **internal linking priorities**, and **AI search readiness**.

= Privacy Friendly =

**GoVISIBLE AI Bot Tracker** is built with privacy in mind.

The plugin stores AI bot visit data **locally inside your WordPress database**. It does **not** send your website data to GoVISIBLE or any external tracking platform.

The plugin is designed to track **AI bot activity**, not human visitor behavior.

= No Premium Upsells =

**GoVISIBLE AI Bot Tracker** is free to use with no premium feature gates.

* **No premium feature locks**
* **No paid upgrade nags**
* **No external tracking** of bot visit data
* **No third-party data collection**

On the plugin’s Dashboard screen, you may see an optional link to GoVISIBLE’s free AI Visibility Audit. Dismissing it hides the strip for seven days.
= Why Choose GoVISIBLE AI Bot Tracker? =

* **Simple AI bot tracking** for WordPress
* **Easy dashboard** for reviewing crawler visits
* Helpful for **SEO** and **GEO** workflows
* Tracks useful details like **bot type**, **IP**, **date**, and **URL**
* Helps identify whether AI crawlers are accessing important content
* Stores data **locally inside WordPress**
* **No external tracking** or third-party data collection
* Built by **GoVISIBLE**, a Generative Engine Optimization platform

**Start tracking AI bot activity on your WordPress site** and understand how AI crawlers interact with your content.

== Installation ==

= Automatic Installation (Recommended) =

1. Go to **Plugins > Add New** in your WordPress admin
2. Search for **"GoVISIBLE AI Bot Tracker"**
3. Click **Install Now**, then **Activate**
4. That's it! Tracking starts automatically
5. View data at **GoVISIBLE AI Bot Tracker** in the admin menu

= Manual Installation =

1. Download the plugin ZIP file
2. Go to **Plugins > Add New > Upload Plugin**
3. Choose the ZIP file and click **Install Now**
4. Activate the plugin
5. Tracking begins immediately

= After Activation =

* The plugin is already working – **no setup required**
* Check **GoVISIBLE AI Bot Tracker** in the admin menu to see collected data

== Screenshots ==

1. Dashboard with KPIs, crawl activity chart, and AI engine breakdown with brand logos
2. AI Engine Activity with multi-engine trends, summary table, bots, and top pages
3. Visit Logs with filters, pagination, and per-row AI engine logos

== Frequently Asked Questions ==

= What does GoVISIBLE AI Bot Tracker do? =
**GoVISIBLE AI Bot Tracker** detects and logs visits from known AI bots, LLM crawlers, and generative search crawlers on your WordPress website.

= Why should I track AI bot visits? =
AI-powered search tools are changing how content is discovered. Tracking AI bot visits helps you understand whether AI crawlers are accessing your website and which pages they are visiting.

= Which data does the plugin log? =
The plugin logs AI bot visits with details such as **bot type**, **visit date**, **IP address**, and **visited URL**.

= Can I see which pages AI bots visited? =
Yes. The plugin records visited URLs so you can see which pages, posts, or landing pages are accessed by known AI crawlers.

= Is this useful for SEO? =
Yes. The plugin complements traditional SEO tools by adding **AI crawler visibility**. It helps you understand how AI bots interact with your WordPress content.

= Will this slow down my website? =
The plugin is lightweight and designed to have minimal impact on page performance.

= Can I see historical AI bot activity? =
Yes. Every detected AI crawler request is stored and can be viewed from the dashboard.

= Does the plugin block AI bots? =
No. **AI Bot Tracker** is a monitoring tool. It records crawler activity but does **not** block requests.

= Does this plugin phone home? =
No. This plugin does not contact any external servers for tracking AI bot visits. The admin dashboard may load the GoVISIBLE logo image for branding only. A promo on the plugin’s admin screens may link out to GoVISIBLE’s free AI Visibility Audit page when you choose to open it.

= Does this plugin track human visitors? =
No. The plugin is designed to track **AI bot and LLM crawler activity**, not human visitor behavior.

= Where is visit data stored? =
All AI bot visit data is stored **locally in your WordPress database**. Nothing is sent to GoVISIBLE or any external tracking platform.

= Is Chart.js compliant? =
Yes. Chart.js is bundled locally and used only as a visualization tool in the admin area.

== External Services ==

This plugin uses **Chart.js**, a third-party JavaScript library, to render data visualizations in the admin dashboard.

Chart.js is loaded from a local plugin copy:

* `assets/js/chart.min.js`

The GoVISIBLE brand logo is bundled locally:

* `assets/images/govisible-logo.png`

The plugin’s Dashboard screen may include a promotional strip linking to GoVISIBLE’s free AI Visibility Audit:

* https://govisible.ai/ai-visibility-audit/

That link opens only when a user clicks it. Dismissing the strip hides it for seven days. Visit logs and crawler analytics remain stored locally and are not sent to GoVISIBLE.

**Disclaimer:**
This plugin is not affiliated with, endorsed by, or sponsored by OpenAI, Google, Anthropic, Perplexity, or any other AI provider. ChatGPT, GPT, Gemini, Claude, and related names are trademarks of their respective owners. This plugin detects and reports on publicly identifiable user agents.

== Changelog ==

= 1.0.7 =
* Added crawl-type classification and AI Crawl Composition dashboard section.
* Added Total Activity / Crawl Composition tabs on the activity chart.
* Added a dismissible Free AI Visibility Audit promo strip on plugin admin screens.

= 1.0.6 =
* Updated the admin logo to use a local image.
* Renamed remaining legacy function prefixes for WordPress coding standards.
* Minor code quality and database query hardening fixes.

= 1.0.5 =
* Fixed AI Engine Activity page rendering blank when engines.php was missing from the WordPress.org package.
* Ensured the AI Engine Activity partial is included in the release and shows a clear message if unavailable.

= 1.0.4 =
* Added a redesigned dashboard with AI Engine Activity and Visit Logs.
* Added AI engine insights, including crawl trends, engine summaries, and top crawled pages.
* Added advanced filtering by date, AI engine, bot, IP address, and URL.
* Improved analytics with engine-level metrics, bot breakdowns, and performance enhancements.
* UI improvements, bug fixes, and overall stability updates.

= 1.0.3 =
* Added support for more AI bots and crawlers
* Improved admin dashboard UI

= 1.0.2 =
* Redesigned admin dashboard with a clearer analytics view

= 1.0.1 =
* Improved how AI bot visit logs are stored and displayed

= 1.0.0 =
* Initial release
