=== PulseTrack - Analytics & Conversion Tracking ===
Contributors: pulsetrack
Tags: analytics, conversion tracking, visitor tracking, privacy, woocommerce
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Privacy-first WordPress analytics for lead and conversion tracking. Lightweight, local-first - no third-party scripts.

== Description ==

Understand which traffic sources generate real leads and conversions - not just pageviews.

PulseTrack is a lightweight, privacy-first WordPress analytics plugin and Google Analytics alternative built for marketers who care about results - all data stays on your own server, with no third-party scripts. Every feature is included and unlocked - there is no paid tier, license, or trial.

= Key Features =

* **Conversion tracking for WordPress** - form submits, phone clicks, WhatsApp, and email leads
* **Traffic source attribution** - search, social, AI referrals, UTM campaigns, direct
* **Privacy-first analytics** - IP anonymization on by default, no third-party data sharing
* **Dashboard** - sessions, users, leads, conversion rate, traffic sources, campaign performance, device/browser breakdown
* **Sessions and users** - accurate counts using fingerprinting, no inflated data
* **Visitor Logs** - per-session activity timeline (time, page, event, source, device)
* **Insights** - automatically scores your most-visited pages and flags priority pages to fix and quick-win opportunities
* **Export reports** - CSV, JSON, and PDF (browser-print report), covering the same data shown on the Dashboard
* **WooCommerce analytics (optional)** - add-to-cart and purchase tracking, revenue and conversion-rate KPIs; appears automatically only once there is ecommerce activity to show, and requires no configuration
* **WordPress privacy tooling integration** - registers with the built-in personal data export/erase tools and privacy policy content
* **Guided first-time setup** - a short onboarding screen on first activation

= Who Is This For? =

* WordPress site owners who want actionable conversion data without Google Analytics
* Marketers tracking lead sources and campaign ROI
* Agencies needing a privacy-conscious analytics dashboard for clients
* WooCommerce stores tracking orders alongside marketing performance

= Why Not Google Analytics? =

* The frontend tracking script does not load third-party scripts
* Analytics tracking data is not sent to external analytics services
* No complexity - focused on leads and conversions, not vanity metrics
* All data stays on your own WordPress server

= Use Cases =

* Track leads from SEO traffic
* Measure campaign conversions inside WordPress
* Understand which pages generate revenue
* Use as a privacy-first alternative to Google Analytics

Built with performance, privacy, and accuracy in mind.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/pulsetrack`, or install directly through the WordPress Plugins screen.
2. Activate the plugin through the 'Plugins' screen.
3. You will be guided through a short first-time setup screen. You can also skip it and configure everything later under PulseTrack &rsaquo; Settings.

== Frequently Asked Questions ==

= Is this a Google Analytics alternative? =
Yes. PulseTrack stores all data on your own WordPress server - no third-party scripts, no data sent to Google. It focuses on conversion tracking and lead attribution rather than raw traffic volume.

= Is this a Pro plugin, or does it have locked features? =
No. PulseTrack has no paid tier, trial, or license. Every feature described here is included and fully unlocked.

= What data is collected, and is IP anonymization on by default? =
PulseTrack records page views, the referring URL, browser/device technical metadata, and (for WooCommerce stores) product and order totals - never a visitor's name, email address, or billing/shipping details. IP anonymization is enabled by default (the last two octets of IPv4 addresses, or the last 64 bits of IPv6 addresses, are masked before the address is ever stored), and can be reviewed at any time under PulseTrack &rsaquo; Settings &rsaquo; Privacy.

= Does PulseTrack send data to any external service? =
No analytics tracking data is sent to any external service. PulseTrack stores analytics data in your own WordPress database.

Two optional admin actions can send information by email, and only when an administrator clicks them: Send Feedback and Send Debug Log. Both disclose exactly what will be sent before you send it. No automatic or scheduled email is ever sent by PulseTrack.

= Does this use cookies? =
Session tracking uses your browser's local storage, mirrored into a first-party cookie of the same name so that server-side events (such as a WooCommerce purchase) can be linked to the same browsing session. You can disable cookies entirely under PulseTrack &rsaquo; Settings &rsaquo; Session Tracking; sessions still work, they are simply not persisted across page loads.

= How long is data kept? =
Raw visitor logs (individual page views and events) are kept for up to 30 days by default. You can shorten this to 14 or 7 days under PulseTrack &rsaquo; Settings &rsaquo; Privacy; 30 days is always the maximum for raw logs. This raw-log window is separate from Dashboard and Insights analytics: PulseTrack keeps privacy-safe aggregated summaries (counts and totals, not individual visitor records) for 90 days, so the Dashboard and Insights 60-day and 90-day views stay exact even after the underlying raw logs have been pruned. This is included and unlocked for every install - there is no separate tier or upgrade required to see it.

= Does WordPress's built-in privacy export/erase tools work with PulseTrack? =
Yes, PulseTrack registers with WordPress's personal data exporter and eraser. In practice, PulseTrack's analytics records are anonymous by design (no user-account link is stored), so a privacy export/erase request will typically only find matching records for a logged-in user whose login session IP happens to match a stored, non-anonymized record - this is a limitation of applying an identity-based request to intentionally anonymous data, not a bug.

= Does it slow down my site? =
No. The tracking script is lightweight, batches requests, and loads asynchronously.

= What happens when I uninstall the plugin? =
By default, deactivating or deleting PulseTrack leaves all of its data in place. If you want PulseTrack to remove its own data (analytics records, settings, and its database tables) when it is deleted, enable "Delete Data on Uninstall" under PulseTrack &rsaquo; Settings &rsaquo; Advanced first. This only takes effect when the plugin is deleted from the Plugins screen, never on ordinary deactivation.

== Screenshots ==

1. The one-step setup wizard - enable tracking and choose your privacy defaults, then you're ready to go.
2. The Marketing Dashboard - sessions, leads, conversion rate, revenue, and traffic sources at a glance over your chosen date range.
3. Period-over-period comparison - see exactly how sessions, leads, users, and revenue changed versus the previous period.
4. The Insights Engine - automatically flags high-impact pages losing conversions and scores your ecommerce performance.
5. Visitor Logs - drill into individual sessions, events, traffic sources, and devices.
6. Settings - control tracking behavior, privacy options, rate limiting, and data retention.

== Changelog ==

= 1.0.1 =
* Added WordPress.org directory branding assets (plugin icon and banner).
* Updated directory Tags and description copy for accuracy and discoverability. No functional or behavior changes.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.1 =
Directory listing and branding update only. No functional changes - upgrading is optional.

= 1.0.0 =
Initial release.
