=== Webnalytics — Privacy-Friendly On-site Analytics ===
Contributors: webnalytics
Tags: analytics, privacy, woocommerce, dashboard, heatmap
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 4.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Privacy-friendly analytics dashboard for WordPress and WooCommerce with pages, referrers, devices, funnels, and heatmaps.

== Description ==

Webnalytics provides an on-site analytics dashboard inside WordPress. It stores analytics data in your WordPress database and displays reports in the admin area.

Features:

* Pages, landing pages, referrers, devices, geographic, and search terms reports
* WooCommerce funnels from product view to add to cart to purchase
* Heatmaps with click density and element percentage mode
* Optional REST export endpoints secured by a local developer token
* Traffic quality report with bot filtering and crawler breakdown
* No external analytics account required for the WordPress.org build

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/webnalytics/`, or install it through the WordPress Plugins screen.
2. Activate the plugin through the Plugins screen in WordPress.
3. Go to **Webnalytics → Settings** to configure tracking and retention.

== Frequently Asked Questions ==

= Does Webnalytics send data to a third-party service? =
No. In this WordPress.org build, Webnalytics runs locally in your WordPress installation and does not send analytics data to any external service.

= Can I disable heatmap tracking? =
Yes. Go to **Webnalytics → Settings** and disable click tracking.

= Can I keep data on uninstall? =
Yes. Add this line to `wp-config.php` before uninstalling:
`define('WEBNALYTICS_KEEP_DATA', true);`

== Screenshots ==

1. Pages report dashboard
2. Heatmap report
3. WooCommerce funnels
4. Settings

== Changelog ==

= 4.0 =
* Replaced the Geographic map view with a cleaner no-map analytics layout.
* Added summary metric cards for countries reached, top market, total visitors, and new visitor share.
* Improved Top Countries and Geo Insights cards.
* Added searchable country table.
* Added Pro upsell messaging for the interactive visitor map.


= 3.7.0 =
* Added a redesigned SaaS-style Geographic report with an interactive bundled SVG world map.
* Added top-country ranking, geo insight cards, search, and click-to-filter country interactions.
* Removed reliance on the old geographic fallback experience on the Geographic report page.
* Kept the geographic visualization lightweight and WordPress.org friendly with no external map dependency.

= 3.6.12 =
* Fixed Devices widget overflow so charts and tables stay inside each card without horizontal scrollbars.
* Removed the Real-Time submenu cleanly and redirected legacy realtime URLs back to Pages.
* Updated plugin header and workspace version badge to 3.6.12.

= 3.6.9.9 =
* Removed Real-Time menu/page cleanly.
* Kept Devices tables within each card without horizontal scroll.

= 3.6.9.8 =
* Fixed Real-Time admin endpoint and polling so the page loads correctly for logged-in admins.
* Kept the existing export/API realtime endpoint intact.
* Added compatibility parsing for both admin and envelope-style realtime responses.

== Upgrade Notice ==

= 3.7.0 =
Recommended maintenance release with WordPress.org compliance, SQL hardening, and minor admin UI polish.

== Privacy ==

Webnalytics stores analytics data locally in your WordPress database to generate reports.

Data collected can include:

* Page paths visited
* Referrer domains
* Device type, browser, and operating system derived from the user agent
* Approximate location fields if configured
* Aggregated funnel steps for WooCommerce
* Heatmap click coordinates when heatmap tracking is enabled

Webnalytics does not require an external account. This build does not transmit analytics data to third parties.

Site owners are responsible for complying with privacy laws applicable to their site, including obtaining consent where required.
