=== Soleil AI Counter ===
Contributors: soleil
Tags: ai, analytics, bot, user-agent, dashboard
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Detects and counts visits from known AI-related user agents in WordPress.

== Description ==

Soleil AI Counter detects and counts visits from known AI-related user agents in WordPress.

The plugin is designed as a neutral AI access meter. It does not judge whether AI access is good or bad. It records detected access facts so site administrators can review them and make their own decisions.

Soleil AI Counter can be useful for sites that want to understand AI-related crawler activity, whether they want to welcome AI access, limit AI access, or simply observe what is happening.

Important limitations:

* Detection is based on User-Agent strings.
* User-Agent values can be spoofed.
* Counts do not guarantee citation, training, indexing, ranking, or inclusion in any AI service.
* Browser, page, CDN, and server caching may affect when WordPress records a request.
* The Free version is designed to avoid storing personally identifying visitor information.
* The Free version does not send data to external services.
* If Soleil AI Counter Pro is active, the Free version pauses its own tracking and UI to avoid duplicate processing.

= Features =

* Detects supported AI-related User-Agent strings.
* Shows today's detected AI-related accesses.
* Shows detected accesses from the past 7 days.
* Shows cumulative detected accesses.
* Shows totals by supported bot.
* Shows the latest detected access time and bot name.
* Shows each supported bot's latest detected time.
* Adds a WordPress admin page under Tools.
* Adds a dashboard widget.
* Provides a simple `[soleil_ai_counter]` shortcode.
* Stores anonymous aggregate counts locally in WordPress options.

= Supported AI Bots =

The Free version includes these default User-Agent fragments:

* GPTBot
* OAI-SearchBot
* ChatGPT-User
* ClaudeBot
* Claude-SearchBot
* PerplexityBot

The list can be filtered by developers with `soleil_ai_counter_bot_patterns`.

= Privacy =

Soleil AI Counter Free is designed to store aggregate count data only.

By default, it does not store:

* IP addresses
* Cookies
* Visitor identifiers
* Referrer URLs
* Raw User-Agent logs

The plugin reads the request User-Agent during a WordPress page request to classify known AI-related bots. If a supported bot is detected, the plugin increments local aggregate counters.

No data is sent to external services by the plugin.

= Cache limitations =

Soleil AI Counter runs inside WordPress. If a request is served entirely by a CDN, web server cache, page cache, or hosting cache before WordPress runs, the plugin may not count that request.

Counts may differ from server logs, CDN logs, analytics tools, or AI service reporting. The plugin is not a complete access log.

== Installation ==

1. Upload the `soleil-ai-counter` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the WordPress Plugins screen.
3. Open `Tools > Soleil AI Counter`.
4. Review the detected aggregate counts.
5. Optionally add `[soleil_ai_counter]` to a post, page, or widget area that supports shortcodes.

== Frequently Asked Questions ==

= Does this prove that my content was cited or used by an AI service? =

No. The plugin only counts requests with known AI-related User-Agent strings. It does not prove citation, training, indexing, ranking, or inclusion in any AI service.

= Can bots fake their User-Agent? =

Yes. User-Agent values can be spoofed, so counts should be treated as approximate detected activity.

= Does the plugin store IP addresses? =

No. The Free version is designed not to store IP addresses.

= Does the plugin send data to an external service? =

No. The plugin stores aggregate counts locally in WordPress options and does not send data to external services.

= Why do counts differ from server logs or analytics tools? =

Soleil AI Counter records requests that reach WordPress and match supported User-Agent fragments. Browser, page, CDN, and server caching may affect whether a request reaches WordPress.

= What happens if Soleil AI Counter Pro is active? =

The Free version detects the Pro plugin and pauses its own tracking, admin UI, dashboard widget, and shortcode registration. It does not automatically deactivate either plugin.

= Can I customize the supported bot list? =

Developers can filter the list with `soleil_ai_counter_bot_patterns`.

== Screenshots ==

1. Admin summary showing today, past 7 days, total, and latest detected AI-related access.
2. Bot totals table.
3. WordPress dashboard widget.

== Changelog ==

= 1.0.0 =

* Initial Free version prepared for WordPress.org distribution.
* Added aggregate AI-related User-Agent detection counts.
* Added Tools admin page.
* Added dashboard widget.
* Added `[soleil_ai_counter]` shortcode.
* Added uninstall cleanup for Free aggregate data.

== Upgrade Notice ==

= 1.0.0 =

Initial Free release. This version stores anonymous aggregate counts locally and does not migrate or delete Pro plugin data.
