=== Azayem Bots Tracker – Bot Visits Logger ===
Contributors: botstracker
Tags: bots, crawler, crawl budget, analytics, seo
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
A custom plugin to log search engine bot visits and analyze their crawl budget directly inside WordPress (no external services required).


== Description ==

Bots Tracker is a custom-built plugin designed to:

- Detect and log visits from search engine bots and crawlers.
- Store visits in a dedicated database table for analysis.
- Display detailed bot visits inside WordPress Admin (with filters, pagination, and per-URL crawl budget).
- Compare crawl budget between two time ranges (current vs previous period).

Main features:

1. **Bot Detection & Logging**
   - Detects various bots (Googlebot, Bingbot, GPTBot, etc.) using User-Agent signatures.
   - Saves bot name, visited URL path, IP address, and visit time to a custom database table.

2. **Admin Dashboard Pages**
   - Main Report: paginate and filter bot visits, with search by URL, bot name, and date range.
   - Crawl Budget by URL: aggregate visits per URL with total hits, unique bots, and first/last visit times.
   - Comparative Report: compare total crawl budget between current and previous periods.

3. **Clean Uninstall**
   - On plugin deletion, the custom database table and plugin options are removed from WordPress to keep your database clean.

4. **Settings & Data Management**
   - Configure how long bot visit logs are stored (data retention in days).
   - Enable or disable bot filtering to store only selected bots (e.g., only Googlebot and Bingbot) or to exclude specific bots.
   - Run on-demand database optimization for the bot visits table directly from the settings page.
   - Manually delete old records using a one-click cleanup tool.
   - Automatic cleanup via WP-Cron based on your configured retention period.


== Privacy ==

This plugin stores the following data about bot visits in a custom database table:
- Bot name (derived from the User-Agent string)
- Bot IP address
- Visited URL path
- Visit timestamp

No data is sent to any third-party servers. This plugin tracks bots only, not human visitors.


== Installation ==

1. Upload the `bots-tracker` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the “Plugins” menu in WordPress.
3. Go to “Bots Tracker” in the admin menu to view bot visits and reports.


== Changelog ==

= 1.0. =
* Changed plugin display name to improve uniqueness and avoid confusion.
* Minor internal improvements and review fixes.

= 1.0.0 =
* Initial custom release with:
  - Bot logging
  - Admin reports
  - Crawl budget analysis
  - Settings page for data retention and bot filtering
  - Clean uninstall behavior