=== Mixpanel Analytics by Volade ===
Contributors: volade
Tags: analytics, mixpanel, tracking, events, privacy
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later

Mixpanel user analytics bridge for WordPress — frontend tracker, server track lite, identify users, 4 presets and free JSON export.

== Description ==

Mixpanel Analytics by Volade connects your WordPress site to [Mixpanel](https://mixpanel.com) for product and user analytics.

* Masked project token — or override via `MXP_PROJECT_TOKEN` / `MIXPANEL_TOKEN` in wp-config.php (no secrets in repo)
* Frontend tracker — Mixpanel JS snippet when enabled; auto page views, optional WP user identify
* Server track lite — `wp_remote_post` to Mixpanel for WP hooks and `do_action( 'mxp_track', $event, $props )`
* Event log — ring buffer with connection status and test event button
* Consent lite — respect Do Not Track, cookie-free mode disables frontend snippet, `[mxp_optout]` shortcode
* 4 presets: Content Site, WooCommerce Lite, SaaS Funnel, Privacy First
* Site Health test, REST `mxp/v1`, WP-CLI `wp mxp`, free JSON export

Mixpanel free tier messaging in copy only — 20M events/month on Mixpanel's free plan.

Works without a Volade account. Connect for REST automation. V+ for advanced funnel features and multisite.

== Installation ==

1. Upload the ZIP via Plugins → Add New → Upload
2. Activate Mixpanel Analytics by Volade
3. Add your Mixpanel project token
4. Enable frontend tracker and/or server track, then send a test event

Optional in wp-config.php:

`define( 'MXP_PROJECT_TOKEN', 'your-token' );`

== Frequently Asked Questions ==

= Does this work without WooCommerce? =

Yes. WooCommerce lite hooks apply only when WooCommerce is active and the option or preset is enabled.

= How do I track custom events from PHP? =

`do_action( 'mxp_track', 'My Event', array( 'foo' => 'bar' ) );`

= What does Privacy First do? =

Enables Do Not Track respect, disables auto identify and frontend snippet (cookie-free note), keeps minimal server events.

== Changelog ==

= 1.0.0 =
* Initial release — settings, frontend tracker, server track, event log, test event, presets, export, REST and WP-CLI.
