=== WhatsLink Click Tracker === Contributors: sani060913 Tags: whatsapp, click-tracker, analytics, utm, tracking Requires at least: 6.0 Tested up to: 6.9 Stable tag: 1.2.2 Requires PHP: 7.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Track every WhatsApp button click in WordPress. See which pages, UTM sources, and campaigns drive real conversations — no code needed. == Description == You have a WhatsApp button on your site. People click it. But you have no idea which page sends the most conversations, which campaign is worth running again, or whether your homepage button even gets used. **WhatsLink Click Tracker** fixes that. Install it, activate it, and every WhatsApp click on your site is logged automatically — post title, page URL, click date, UTM source, UTM campaign, UTM medium, and referrer. No code changes. No Google Tag Manager. No custom events. It works with any theme, any page builder, and any WhatsApp link format: * `https://wa.me/` * `https://api.whatsapp.com/send` --- ### What the free version gives you * **Click log dashboard** — every WhatsApp click with title, URL, date, and UTM data * **Live search and pagination** — find any click in seconds * **Sortable columns** — sort by page, date, or click type * **UTM tracking** — source, medium, and campaign logged automatically * **Referrer tracking** — see where traffic came from * **Stats bar** — total clicks, last 30 days, and top page at a glance * **Date range filter** — view logs for last 7 days, last 30 days, or all time * **Top Pages** — see the 5 pages driving the most WhatsApp clicks * **Badge counter** — show total click counts next to each WhatsApp button on your pages * **One-click reset** — clear old data when needed * **GDPR-friendly** — no IP addresses, no geolocation, no personal data Works on posts, pages, WooCommerce products, and any other post type. --- ### Why upgrade to Pro? The free version tells you *what* happened. Pro tells you *why* and helps you act on it. 👉 [WhatsLink Click Tracker Pro →](https://wpsani.store/downloads/whatslink-tracker-pro/?utm_source=wordpress_plugin&utm_medium=readme&utm_campaign=whatslink_tracker_pro) **Pro adds:** * Advanced dashboard with date range, post type, permalink, and UTM filters * KPI overview — total clicks, top sources, top URLs at a glance * Trend chart — see click volume over time * Top Sources, Mediums, Campaigns, Pages, and URLs charts * CSV export — download your full click log anytime * Real-time email notifications — get alerted on each new click * Daily and weekly summary reports * Priority support --- == Features == = FREE VERSION = * Detects clicks on all WhatsApp links (wa.me and api.whatsapp.com) * Works on posts, pages, WooCommerce products, and custom post types * Tracks post title, post type, permalink, clicked URL, and datetime * Tracks utm_source, utm_medium, utm_campaign * Tracks referrer * Stats bar — total clicks, last 30 days, and top page on the dashboard * Date range filter — All time, Last 30 days, Last 7 days * Top Pages — 5 most-clicked pages with click counts * AJAX dashboard with live search, pagination, and sortable columns * Optional badge counter showing total clicks per link * One-click log reset * Lightweight — no external services, no tracking scripts * GDPR-friendly: no IP or location data stored = PRO VERSION = * Advanced report filters (date range, permalink, post type, UTM) * KPI overview dashboard * Trend chart over time * Top Sources, Mediums, Campaigns, Pages, and Clicked URLs charts * Export full click log to CSV * Real-time email notifications per click * Daily and weekly summary email reports * Priority support 👉 [Upgrade to Pro →](https://wpsani.store/downloads/whatslink-tracker-pro/?utm_source=wordpress_plugin&utm_medium=readme&utm_campaign=whatslink_tracker_pro) --- == Screenshots == 1. Main dashboard — stats bar (total clicks, last 30 days, top page), click log with search, sorting, pagination, and UTM data. 2. Reports Dashboard with filters and KPIs (Pro). 3. Top Pages chart (Pro). 4. Top Clicked URLs chart (Pro). 5. Badge counter displayed next to WhatsApp links on the page. 6. Email notification settings (Pro). 7. CSV export from click logs (Pro). 8. Badge counter enable/disable setting in plugin settings. --- == Installation == 1. Install the plugin from the WordPress plugin directory or upload the zip manually. 2. Activate it from the Plugins screen. 3. Go to **Tools → WhatsLink Click Tracker** to see your click log. No configuration required. Tracking starts immediately after activation. --- == Frequently Asked Questions == = Does it work with Elementor, Divi, Beaver Builder, and other page builders? = Yes. WhatsLink detects clicks on WhatsApp links regardless of how they were added to the page — through any theme, page builder, or widget. = Which WhatsApp link formats does it support? = Both `https://wa.me/` and `https://api.whatsapp.com/send` are detected automatically. = How does the click tracking work? Does it modify my WhatsApp links? = No. WhatsLink uses a JavaScript event listener to detect clicks. Your links are never modified — they still open WhatsApp directly as usual. The click is just logged silently in the background. = What is the badge counter? = An optional feature that shows the total number of clicks next to each WhatsApp button on your pages. Useful for social proof or internal monitoring. = What's the difference between the free version and Pro? = The free version gives you the full click log with UTM and referrer data. Pro adds advanced filtering, visual charts, CSV export, and automated email reports. See the full comparison above. = Is it compatible with WooCommerce? = Yes. WhatsApp clicks on product pages are tracked and labeled by product title and type. = Is it GDPR compliant? = The Free version stores no IP addresses, no location data, and no personal user information — only anonymized click events tied to page URLs. = Will it slow down my site? = No. Click logging is asynchronous (uses the browser's sendBeacon API) and has no impact on page load time. = How many clicks can it store? = There is no hard limit. Clicks are stored in your WordPress database. You can reset the log at any time from the dashboard. = Can I export my click data? = CSV export is available in the Pro version. --- == Changelog == = 1.2.2 = * New: Empty state screen when no clicks have been logged yet — confirms tracking is active and guides new users. = 1.2.1 = * Internal: update plugin assets on WordPress.org (screenshots, icons). = 1.2.0 = * New: Stats bar on the dashboard — total clicks, last 30 days, and top page at a glance. * New: Date range filter — filter the log by last 7 days, last 30 days, or all time. * New: Top Pages section — 5 most-clicked pages with a Pro upsell for full analytics. * Fix: Click tracking was silently disabled for all non-admin visitors (critical bug). * Fix: SQL queries used hardcoded table prefix — broken on sites with a custom DB prefix. * Fix: Sortable columns were ignored for all columns except Post Title. * Fix: Column sorting stopped working after pagination or search due to lost JS listeners. * Fix: Admin JS was loaded on all admin pages instead of only the plugin dashboard. * Fix: Global variable names in the dashboard template now use the full plugin prefix. * Fix: SQL queries restructured to pass WordPress Plugin Check without errors. = 1.1.2 = * Fix: Prevent database queries before plugin table is created on activation. = 1.1.1 = * Free version now includes UTM tracking (source, medium, campaign) and referrer. = 1.1.0 = FREE: * Added badge counter on WhatsApp links showing total clicks per link. * Added Clicked URL column to the dashboard. * Refactored click count logic into a dedicated module. * Improved logging reliability with sendBeacon. * Security improvements. PRO: * Advanced report filters (date range, post type, permalink, UTM). * KPI overview in Reports. * Trend chart over time. * Top Sources, Mediums, Campaigns, Pages, and Clicked URLs charts. * Internal improvements and compatibility updates. = 1.0.1 = * Security and stability improvements. = 1.0.0 = * Initial release. --- == Upgrade Notice == = 1.2.0 = Critical fix: click tracking was not working for regular visitors. Update immediately. Also adds stats bar, date filter, Top Pages, and full WordPress Plugin Check compliance. = 1.1.2 = Stability fix for plugin activation. Recommended update for all users.