=== Inpweb Visitor Counter ===
Contributors: danfer24
Tags: visitor counter, traffic analytics, social proof, bot filter, real-time analytics
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPL2

Professional Traffic Radar for WordPress. Track real human visitors, filter out malicious bots, and forensic exports. 100% Free and Responsive.

== Description ==

**Inpweb Visitor Counter** is a professional-grade analytical tool designed for WordPress site owners who need clean, reliable data. Unlike standard counters that inflate numbers with bot traffic, Inpweb uses a "Human-First" engine to provide an accurate picture of your real audience.

It provides a high-impact dashboard to monitor your traffic while automatically filtering out malicious crawlers and spiders.

**Key Features:**
*   **Intelligent Anti-Bot Filter:** Advanced detection of 20+ bot patterns (Google, Bing, Facebook, etc.) to ensure your data is 100% human.
*   **Visitor Geolocation:** Automatically identifies the country of origin for every unique visitor.
*   **Granular Visibility Control:** Choose exactly which pages or posts will display the public "Social Proof" counter.
*   **Professional Dashboard:** A sleek, 3-column command center with real-time global activity simulation.
*   **Forensic Data Export:** Download comprehensive CSV reports for external analysis or client reporting.
*   **Privacy Focused:** Lightweight and compliant. We don't store sensitive PII data.

== External Services ==

This plugin uses the following third-party service to provide visitor geolocation:

*   **IP-API (ip-api.com):** This service is used to identify the country of a visitor based on their IP address. This helps site owners understand their audience distribution.
*   **Service URL:** http://ip-api.com/
*   **Terms & Privacy:** https://ip-api.com/docs/legal

*Note: Only the anonymized IP address is sent to the API for lookup. No other site data is shared.*

== Installation ==

1. Upload the `inpweb-visitor-counter` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Your analytics dashboard will appear under the **'Inp-Counter'** menu in your sidebar.

== Screenshots ==

1. **The Command Center:** A beautiful, responsive admin interface showing real-time human traffic vs blocked bots.
2. **Social Proof Bubble:** How the elegant, minimalist counter looks on your live pages.
3. **Traffic Insights:** Top 5 countries report and data management tools.

== Changelog ==

= 1.1.0 =
*   **Security Patch:** Improved IP validation and sanitization for PHP 8.2+.
*   **Stability Fix:** Corrected database table creation logic to prevent critical errors.
*   **SEO Update:** Enhanced description and tags for better repository visibility.
*   **External Service Disclosure:** Added required technical disclosure for IP-API usage.

= 1.0.9 =
*   Initial stable release.
*   Added CSV Export functionality.
*   Implemented transient-based caching for API calls.