=== Epic Tracking – Click & Event Tracking for WordPress ===
Contributors: epicwpsolutions
Tags: event tracking, click tracking, analytics, page views, statistics
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.3.8
Requires PHP: 7.4
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Click and event tracking for WordPress. Point, click, and track — no code, no tag managers, no third-party scripts.

== Description ==

Epic Tracking lets you add event tracking to any element on your WordPress site using a visual editor. Click the element you want to track, give it a name, and you're done — events start recording immediately. No code, no Google Tag Manager, no external scripts.

= Visual Click & Event Editor =

Open the visual editor on any page from the WordPress admin bar. Click a button, link, form, CTA, or any other element — give it a reference name and tag — and save. That's it. The event is live and tracking starts immediately.

* Track button clicks, form submissions, link clicks, and CTA conversions
* Set up events in seconds with a point-and-click interface
* Organize events with custom tags for easy filtering
* No coding or tag manager knowledge required

= Built-in Analytics Dashboard =

The plugin includes a full analytics dashboard in your WordPress admin:

* Event trigger counts with unique visitor breakdowns
* Page view statistics with date range filtering
* Per-page detail views with referrer, device, browser, OS, and country data
* Daily traffic charts and trend visualization
* Sortable tables with pagination

= Self-Hosted & Privacy-Friendly =

All tracking data stays in your WordPress database. No data is sent to third-party analytics services. Visitors are identified using a single first-party cookie — no personal data is stored or shared.

= Features =

* **Visual event editor** — Point-and-click setup for tracking clicks on any element
* **Custom event tags** — Organize events with tags for easy filtering and reporting
* **Event analytics** — See which events fire most, with trigger counts and unique visitors
* **Page view tracking** — Automatic visit logging with full referrer and device data
* **Country geolocation** — Automatic IP-based country detection for visitor locations
* **Bot filtering** — Known bots and crawlers are automatically excluded
* **Role exclusion** — Exclude administrators or any user role from being tracked
* **Date range filtering** — Quick presets (today, last 7 days, last 30 days) and custom ranges
* **Lightweight** — No impact on page load speed; tracking runs asynchronously after render
* **Self-hosted** — All data stored in your WordPress database, no external dependencies
* **Clean uninstall** — All tables and options are removed when you delete the plugin

= Use Cases =

* Track which CTAs and buttons get the most clicks on your landing pages
* Measure form submission rates and conversion events without tag managers
* Monitor page views and traffic trends without Google Analytics
* See which referrers drive the most traffic to specific pages
* Understand visitor demographics: device type, browser, OS, and country

= Why Epic Tracking? =

Most WordPress event tracking requires Google Tag Manager, custom JavaScript, or expensive third-party services. Epic Tracking gives you a visual editor to set up event tracking in seconds — no code, no external scripts, no data leaving your server.

== Installation ==

1. Upload the `epic-tracking` folder to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Navigate to **Tracking** in the admin sidebar to view your dashboard.
4. To set up event tracking, visit any page on your site and click **Edit Tracking** in the admin bar.

== Frequently Asked Questions ==

= Does this plugin use cookies? =

Epic Tracking sets a single first-party cookie (`epictr_visitor_id`) to identify returning visitors across page views. No personal data is stored in this cookie — it contains only a randomly generated anonymous identifier.

= Does this plugin send data to external services? =

All tracking data is stored in your WordPress database. The only external request is an optional IP geolocation lookup to ip-api.com to determine visitor country. No personal data is shared with this service.

= Is this plugin GDPR compliant? =

Epic Tracking is designed with privacy in mind. It stores no personal data and keeps all data on your own server. The only cookie used contains a random anonymous identifier — no personal information. No data is shared with third parties.

= Will this slow down my site? =

No. Visit logging happens via an asynchronous AJAX request after the page has fully loaded, so it does not affect page render time or Core Web Vitals.

= How do I track button clicks or form submissions? =

Visit any page on your site and click **Edit Tracking** in the WordPress admin bar. This opens the visual editor where you can click on any element to set up tracking — no code required.

= Can I see which pages get the most traffic? =

Yes. The dashboard shows a sortable table of all pages with total visits and unique visitors. Click any page to see a detailed breakdown including referrers, devices, browsers, OS, and countries.

= How are visitors identified? =

Visitors are assigned a randomly generated anonymous identifier stored in a first-party cookie. No personal data is stored.

= What happens when I uninstall the plugin? =

All plugin database tables and options are removed when you delete the plugin through the WordPress admin. Deactivating the plugin does not remove data.

= Can I exclude certain user roles from tracking? =

Yes. Go to **Tracking > Settings** and select which roles should be excluded from visit and event tracking.

= How does bot filtering work? =

The plugin maintains a list of known bot and crawler user-agent patterns. Requests matching these patterns are automatically excluded from tracking data.

== External services ==

This plugin uses the [ip-api.com](http://ip-api.com) geolocation service to determine visitor country based on their IP address. An HTTP request is sent to ip-api.com each time a new visitor is recorded (unless a cached result is available). The request contains only the visitor's IP address. No other personal data is sent.

* Service: [ip-api.com](http://ip-api.com)
* Data sent: visitor IP address
* When: on each new visit (results are cached for 24 hours)
* Terms of service: [ip-api.com/docs/legal](https://ip-api.com/docs/legal)
* Privacy policy: [ip-api.com/docs/legal](https://ip-api.com/docs/legal)

== Screenshots ==

1. Visual editor — point and click to set up event tracking on any element.
2. Dashboard — visit and event statistics with date filtering.
3. Page detail — per-page breakdown with events, referrers, devices, browsers, OS, and countries.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release of Epic Tracking.
