WPMC Behavior & Heatmap — Developer Docs (Summary)

• User ID sync: validate UUID, store in localStorage + wpmc_user_id cookie (2y), export to window.wpmc.user_id.
• Session: wpmc_session and wpmc_session_ts (30-min timeout) for grouping events.
• Events:
  • Page view → wpmc_extended_save_view (session_id, user_id, url, referrer, device)
  • Scroll depth → 25/50/75/100 → wpmc_extended_save_view_scroll
  • Time on page → beforeunload via sendBeacon → wpmc_track_duration (seconds)
  • Admin exclusion: if wpmc_ajax.is_admin_user or wpmc_extended_ajax.is_admin_user → skip

• Menu/Pages: Dashboard (wpmc-dashboard), Heatmap Page List (wpmc-clicks-map), Statistics (wpmc-statistics), Settings (wpmc-clicks-settings), About (wpmc-about).
• Navigation: search by title + Prev/Next across URLs; tabs: Desktop/Mobile; main tabs: Click Map / Referral Sources.
• Online users: header widget, refresh every 30s via AJAX.
• Data reset: per-URL (clicks+views), destructive w/ confirmation.

Public pages update last_activity in wpmc_sessions by wpmc_user_id cookie. Online = DISTINCT user_id active in last 5 minutes (optional 30-min mode).

• Init: chart-init.js fetches JSON by date range with wpmc_chart_nonce.
• wpmc_chart_views (daily views), wpmc_chart_users (uniques), wpmc_chart_top_pages (Top-10), wpmc_chart_referrals (multi-series), wpmc_chart_device_type (doughnut), wpmc_chart_timespent (horizontal distribution).
• Alt loader: chart-scripts.js → wpmc_get_chart_data for simple views-over-time.

• All chart AJAX check wpmc_chart_nonce and log invalid requests.
• Admin ops (wpmc_reset_data, wpmc_get_online_users_count) use dedicated nonces + capability checks.
• Tracking endpoints accept sanitized fields only.

• wpmc_clicks: selector/label, coords, scroll/viewport, link URL, action_type (click|navigation), device_type, semantics (type/subtype/area), label_hash, window/element sizes, timestamp.
• wpmc_views: session_id, user_id, page_url, referrer_type (Direct/Internal/External), referrer_url, device_type, duration_seconds, scroll_depth, post_type, timestamp (+ index session_id,user_id).
• wpmc_sessions: session_id (PK), user_id, created_at, end_time, last_activity, device_type, referrer_type, referrer_url, user_agent.
• wpmc_mouse_trails: session_id, page_url, trail (LONGTEXT JSON), device_type, sizes, timestamp (+ index session_id,page_url).

Schemas in db-setup.php; legacy cols removed; last_activity ensured.

• Rendered via iframe-render.php with type="module" scripts; mobile branch delays for lazy elements.
• Panel above iframe (panel-above-iframe.php): color pickers (click/nav/CTA), saved via nonce-protected form.
• Dot data passes into iframe and draws via inject-clicks.js.

Developers can also control the visualization mode directly from scripts or integrations:

// Switch to Heatmap
window.WPMCStd.setMode('heatmap');

// Switch back to Dots
window.WPMCStd.setMode('dots');

// Force re-render of the current mode
window.WPMCStd.reRender();

Alternatively, the mode can be controlled via postMessage:

// Enable Heatmap
{ type: "WPMC_STD_MODE", mode: "heatmap" }

// Enable Dots
{ type: "WPMC_STD_MODE", mode: "dots" }