=== BotSieve – Bot & Fake Traffic Detector ===
Contributors: custonis
Tags: security, bot detector, ai crawler, analytics, traffic monitor
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Detect bots, AI crawlers and suspicious traffic on your WordPress site. Monitor traffic quality in real time with a modern lightweight dashboard.

== Description ==

BotSieve helps website owners understand who is actually visiting their website.

Traditional analytics tools count nearly all requests equally, including bots, crawlers, scanners and suspicious traffic. BotSieve focuses on traffic quality and behavioral analysis instead of raw traffic numbers.

The plugin analyzes incoming requests locally on your WordPress installation and classifies traffic into categories such as:

- Real visitors
- AI crawlers
- SEO crawlers
- Known bots
- Suspicious requests

BotSieve provides a modern dashboard with real-time traffic insights and crawler intelligence.

== Features ==

- Traffic Quality Overview (last 24 hours)
- Real visitor vs crawler detection
- AI crawler detection
- Suspicious traffic detection
- Top detected bots overview
- Average trust score
- Request activity timeline
- Behavioral crawler insights
- Rapid crawl detection
- URL exploration detection
- Lightweight modern dashboard UI
- No external API calls
- No third-party tracking
- Local-only data storage

== Dashboard Overview ==

BotSieve includes:

- Traffic Quality cards
- Real vs crawler traffic distribution
- Top Bots monitoring
- Traffic activity timeline
- Behavioral insights
- Aggressive crawler detection
- Trust scoring system
- Live monitoring interface

== Use Cases ==

BotSieve is useful for:

- Website owners
- SEO professionals
- Publishers and bloggers
- Lead generation websites
- Security-conscious site operators
- AI crawler monitoring
- WordPress administrators
- Anyone interested in cleaner traffic analytics

== Privacy ==

BotSieve does not send collected traffic data to external servers.

All request analysis happens locally inside your WordPress installation.

The plugin stores request-related metadata such as:

- URLs
- Request timestamps
- User agents
- Request behavior patterns
- Hashed IP information

No personal visitor profiles are created.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate the plugin through the WordPress admin
3. Open "BotSieve" in the WordPress dashboard

== Frequently Asked Questions ==

= Does BotSieve block bots? =

No. BotSieve focuses on traffic analysis, classification and monitoring.

= Does BotSieve work with caching plugins? =

Yes. BotSieve is designed to work alongside common WordPress caching setups.

= Does the plugin affect performance? =

BotSieve is lightweight and optimized for minimal performance impact.

= Does BotSieve use external APIs? =

No. The plugin works fully locally without external API calls.

= Is visitor data sent to third parties? =

No. All collected data remains on your own WordPress installation.

= What types of bots can BotSieve detect? =

BotSieve can detect:

- AI crawlers
- SEO crawlers
- Known bots
- Suspicious scanners
- Behavioral crawlers
- Exploratory requests

== Changelog ==

= 1.1.0 =
* Added AI crawler detection improvements
* Added behavioral analysis engine
* Added rapid crawl detection
* Added trust score system
* Added crawler profile system
* Added aggressive crawler insights
* Added traffic activity timeline improvements
* Improved dashboard UI and mobile experience
* Improved request classification
* Improved WordPress 7.0 compatibility
* Improved sanitization and escaping
* Performance optimizations
* Various bug fixes and stability improvements

= 1.0.1 =
* Improved WordPress.org compatibility
* Improved sanitization and escaping
* Improved admin menu integration
* Minor review fixes

= 1.0.0 =
* Initial release
* Traffic quality dashboard
* Bot detection
* Top bots overview
* Activity monitoring

== Upgrade Notice ==

= 1.1.0 =
Major feature update with AI crawler intelligence, behavioral detection and dashboard improvements.

= 1.0.1 =
Recommended update with compatibility and security improvements.

= 1.0.0 =
Initial release of BotSieve.