=== 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.