=== Haychdev Heatmaps ===
Contributors: haychdev
Tags: heatmap, analytics, click tracking, scroll map, privacy
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Click and scroll heatmaps that live entirely in your own database. No cookies, no third-party trackers, no consent banner required.

== Description ==

Haychdev Heatmaps shows you where visitors click and how far they scroll — as a heat overlay on your live pages.

Unlike heavyweight heatmap services, it is built differently:

* **Your data stays yours.** Everything is stored in your own WordPress database. Nothing is sent to third-party servers.
* **Genuinely lightweight.** A <4KB cookieless tracker sends a single request per pageview.
* **Privacy-first by architecture.** No cookies, no IP storage, no fingerprinting, no PII. GDPR-friendly out of the box.
* **View heatmaps on your real pages.** Open any page with the floating toolbar and see clicks and scroll depth overlaid on the live, responsive layout.
* **Hover for exact numbers.** Move your cursor over any heated area to see the click count and its share of the page (or, in scroll mode, the percentage of visitors who reached that depth).

The free tier gives you click heatmaps on your top 3 pages (desktop view, 30-day retention). A [pro license](https://haychdev.com/plugins/lightmap) unlocks heatmaps on every page, scroll maps, device segmentation, 90-day retention, and CSV export.

== Installation ==

1. Install and activate from the Plugins screen.
2. Visit the Heatmaps menu in wp-admin. Tracking starts automatically.
3. After some traffic arrives, click "View heatmap."

== Frequently Asked Questions ==

= Does it slow down my site? =
The tracker is under 4KB, loads deferred, and sends one request per pageview. Heavy pages are automatically sampled.

= Where is my data stored? =
In three custom tables in your own WordPress database. Deleting the plugin removes them completely.

= Do I need a cookie consent banner? =
The plugin sets no cookies and stores no personal data. Consult your own counsel, but the architecture is consent-banner-friendly by design.

= How long is data kept? =
30 days on the free tier. A pro license extends this to 90 days (configurable further with the `lightmap_retention_days` filter).

= What does a pro license unlock? =
Heatmaps on every page (free is limited to your top 3), scroll-depth maps, device segmentation (desktop/tablet/mobile), 90-day retention, and CSV export of raw click events. Purchase at [haychdev.com/plugins/lightmap](https://haychdev.com/plugins/lightmap).

== Screenshots ==

1. Click heatmap rendered as a live overlay on your real page, with the floating toolbar (clicks/scroll modes, device switcher, date range, totals) and a hover tooltip showing the click count for the area under the cursor.
2. The admin screen: per-page traffic table, tracking settings, and one-click data reset.

== Changelog ==

= 0.3.0 =
* Introduced free and pro tiers. Free: click heatmaps on top 3 pages, desktop view, 30-day retention. Pro: all pages, scroll maps, device segmentation, 90-day retention, CSV export.
* License key activation via haychdev.com — keys validated against a thin proxy (no direct Lemon Squeezy calls from the plugin). Daily background recheck with a 3-failure grace period.

= 0.2.0 =
* All features were free and fully functional: heatmaps for every page and 90-day retention.
* New: hover over any heated area to see its click count and share of the page (scroll depth percentage in scroll mode).
* Removed the bundled licensing/external-service integration.

= 0.1.1 =
* Top-level admin menu instead of sitting under Settings.
* Page view/click counts in the admin table now appear immediately, including same-day traffic, instead of waiting for the nightly aggregation.

= 0.1.0 =
* Initial release: click/tap heatmaps, scroll-depth maps, device segmentation, privacy-first tracking.
