=== Linkyy - A Link Click Tracker ===
Contributors: linkyy
Tags: click tracking, analytics, link tracking
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight link click tracking with admin dashboard analytics for WordPress.

== Description ==

Linkyy tracks link clicks on your WordPress site and provides a clean admin dashboard to analyze which links get the most clicks.

**Features:**

* Lightweight frontend scripts (< 4KB gzipped)
* Admin dashboard with sortable table view
* Filter by date range, device type, and visitor type
* Consent mode support for GDPR compliance
* Role-based tracking exclusions
* Automatic data retention cleanup

**Want more? [Upgrade to Linkyy Pro](https://linkyy.io)**

* Visual heatmap overlay with color-coded click badges on your live pages
* Click count badges & tooltips with desktop/mobile and logged-in/out breakdowns
* CSV / JSON export for page-level or site-wide analytics
* Role-based overlay access controls
* Priority email support & lifetime updates

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/linkyy/`
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Configure settings under Linkyy > Settings

== Frequently Asked Questions ==

= Does this slow down my site? =

The two frontend scripts total just 7.2KB raw (under 4KB gzipped) and load asynchronously. They have zero impact on page rendering.

= What links does it track? =

Linkyy automatically tracks clicks on all links (`<a>` tags) across your site. No manual setup is required. Common page builder editor classes (Elementor, Beaver Builder, WPBakery, Bricks, etc.) are automatically excluded to avoid tracking builder UI clicks.

= Does it track admin users? =

By default, administrators are excluded from tracking. You can configure which roles are excluded under Linkyy > Settings.

= Is it GDPR compliant? =

Linkyy does not store any personal data — it only records aggregated daily click counts per link. It also includes configurable data retention and a manual consent mode that lets you delay tracking until visitor consent is granted.

= How does the confidence rating work? =

Each link receives a Low, Medium, or High confidence rating based on its total click count. The thresholds are customizable in settings (defaults: 10 for Medium, 50 for High).

= What's in Linkyy Pro? =

Linkyy Pro adds visual heatmap overlays, click count badges, CSV/JSON export, and role-based overlay access. Learn more at [linkyy.io](https://linkyy.io).

== Screenshots ==

1. Admin dashboard — sortable table with click counts, device breakdown, and confidence ratings.
2. Settings page — configure data retention, role exclusions, consent mode, and confidence thresholds.

== Changelog ==

= 1.0.0 =
* Initial release