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

Privacy-friendly on-site analytics dashboard for WordPress & WooCommerce with pages, referrers, devices, real-time, funnels and heatmaps.

== Description ==

Webnalytics — Privacy-Friendly On-site Analytics 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, Top Landing Pages, and Real-Time views
* Referrers, Devices, Geographic, and Search Terms
* WooCommerce funnels (view product → add to cart → purchase)
* Heatmaps (click density + element % mode)
* Optional REST export endpoints secured by a local Developer Token

This plugin does not require an external account or service to work.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/webnalytics/`, or install via 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 ==

= 3.4.25 =
* Heatmap: Raw interaction capture now posts as structured fields (WAF-friendly) with JSON fallback.
* Heatmap: More lenient page path mapping (prefers runtime location path over cached localization).

= 3.4.24 =
* Heatmap: Interaction-based sampling (tap + movement) with beacon transport for more reliable capture (especially on mobile).

= 3.4.23 =
* Heatmap: Improve click capture on touch devices (iOS/Android) by correctly reading touch coordinates in capture-phase handler.

= 3.4.15 =
* Fix: REST export token permission callback (prevents fatal error when calling /wp-json/webnalytics/v3/export/*).

= 3.4.14 =
* Fix: Heatmap click capture works for logged-out visitors (admin-ajax nopriv).

= 3.4.12 =
* Fix: Prevent duplicate admin menus/widgets when multiple plugin copies are installed.

= 3.4.10 =
* Heatmap: URL field syncs with iframe navigation.
* Core stability improvements.

== Upgrade Notice ==

= 3.4.12 =
Prevents duplicate admin rendering if multiple plugin copies exist.

== Privacy ==

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

Data collected can include:

* Page paths (URLs) visited
* Referrer domains
* Device type, browser, and OS (derived from user agent)
* Approximate location fields if configured (country/city)
* 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 (e.g., GDPR/CCPA), including obtaining consent if required.