=== ADCT Contact Click Tracker ===
Contributors: benjamindimalanta
Tags: tracking, analytics, whatsapp, leads, woocommerce
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Track contact-button clicks (WhatsApp, phone, showroom) with marketing attribution, session grouping, and an admin reporting dashboard.

== Description ==

ADCT Contact Click Tracker records visitor contact clicks — WhatsApp, phone, showroom, floating buttons, and footer `tel:` links — and pairs each click with marketing attribution (UTMs, `gclid`, landing page, referrer) so you can see which campaigns actually drive enquiries.

= Features =

* **Contact click tracking** — WhatsApp, phone, showroom, floating buttons, and footer `tel:` links
* **Marketing attribution** — 30-day first-touch cookie for UTMs, `gclid`, landing URL, and referrer
* **Session grouping** — one card per browser tab session, with every click preserved inside
* **Visitor context** — device and browser (detected locally from the user agent)
* **WooCommerce ready** — product snapshot (title, price, mileage, image) on product pages
* **Admin dashboard** — Overview, Leads, and Sessions pages with filters, pagination, and CSV export
* **Role-based access** — grant reporting access to specific WordPress roles

= Privacy =

All tracking data is stored only in your site's own database — nothing is sent to any external or third-party service. Visitor IP addresses are one-way hashed (SHA-256) before storage and are never retained in plain text. Country is recorded only when your site is behind Cloudflare, read from the standard geo request header Cloudflare already provides; no IP address is sent anywhere to obtain it.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/adct-contact-click-tracker`, or install through the WordPress Plugins screen directly.
2. Activate the plugin through the **Plugins** screen.
3. The tracking database table is created automatically on activation.
4. Open **ADCT Contact Click Tracker** in the admin sidebar to view reports.
5. Clear any page cache (WP Rocket, Cloudflare, etc.) after install or updates.

= Theme integration =

Add `data-track="contact"` attributes to the contact links you want tracked:

`<a href="https://wa.me/1234567890"
   data-track="contact"
   data-contact-type="whatsapp"
   data-agent-id="1"
   data-agent-name="Sales Agent"
   data-source="product_card">
   WhatsApp
</a>`

Supported `data-contact-type` values: `whatsapp`, `phone`, `showroom_landline`, `floating_whatsapp`, `floating_phone`.

== Frequently Asked Questions ==

= Does this work without WooCommerce? =

Yes. WooCommerce is optional and only used to enrich product-page tracking with product title, price, mileage, and image.

= Who can see the reporting dashboard? =

Administrators always have access. Site admins can grant access to additional roles from the plugin's Access control panel.

= Does a click confirm a message was sent or a call was completed? =

No. Tracked clicks are contact intents (the visitor clicked a contact element), not confirmed conversations.

== Screenshots ==

1. Overview dashboard with contact-click breakdown and traffic sources.
2. Leads page listing individual contact clicks.
3. Sessions page grouping clicks by visitor session.

== Changelog ==

= 1.0.0 =
* Initial public release on WordPress.org.

== Upgrade Notice ==

= 1.0.0 =
Initial public release.
