Live Visitor Geo Pulse
Privacy-first live visitor presence for OpenCart.
A lightweight OpenCart 4 module that gives store owners a real-time dashboard of active visitors, country distribution, and device mix without storing IP addresses, adding custom database tables, or depending on Redis or a Node.js worker.
Features
Built for store owners who want live insight without analytics bloat.
Live Admin Dashboard
Track active visitors, countries active, top country, and new visitors in the last minute directly from the OpenCart module settings page.
Country Breakdown
Aggregate anonymous visitor presence by coarse country code so merchants can understand current geographic traffic at a glance.
Device Mix
See how current traffic is split across desktop, mobile, and tablet without attaching any personal identity to the visit.
Privacy-First Tracking
No raw IP storage, no persistent visitor history, and no customer profile creation. Only short-lived anonymous presence data is kept.
Preview Traffic Mode
Generate sample visitors from the admin side so the dashboard can be demoed, reviewed, or screenshotted without needing real shoppers.
OpenCart-Native Integration
Built with OpenCart MVC-L patterns and a Bootstrap 5 admin interface that feels consistent with the native OpenCart backend.
How it works
From storefront heartbeat to native OpenCart admin dashboard in five steps.
- 01
Visitor opens the storefront
An invisible frontend tracker is injected through the footer event flow, so there is no public analytics widget on the storefront.
- 02
Heartbeat is sent
The browser posts a lightweight heartbeat on a configurable interval using an anonymous visitor token and device hint.
- 03
Presence is summarized
The module resolves a coarse country code, updates short-lived presence storage, and refreshes aggregate counts without persisting personal data.
- 04
Dashboard refreshes
The OpenCart admin dashboard polls the summary endpoint and re-renders the live cards, country table, and device mix in place.
- 05
Stale visitors expire
When heartbeats stop, presence entries age out automatically from short-lived file storage, so the dashboard stays current without cron jobs.
Privacy by design
The module is designed to keep tracking anonymous, short-lived, and operationally lightweight.
- No IP addresses are stored in the module's runtime data.
- Only coarse country and device summaries are kept.
- Presence data is short-lived and automatically expires.
- No custom analytics tables are added to the OpenCart database.
- No Redis, Node.js worker, or third-party analytics service is required.
- Storefront shoppers do not see a public-facing widget or dashboard.
Requirements
| OpenCart | 4.0+ |
| Tested up to | 4.1.0.3 |
| PHP | 8.3+ |
| Storage | Standard OpenCart file storage |
| Database | No custom tables required |
| Extra services | None |
Installation
- 01 Download the .ocmod.zip package for the module.
- 02 In OpenCart admin, go to Extensions -> Installer and upload the archive.
- 03 Open Extensions -> Extensions and choose Modules from the extension type filter.
- 04 Install Live Visitor Geo Pulse.
- 05 Open the module settings page, enable the module, and save.
- 06 Visit the dashboard panel and use preview traffic if you want to test the interface without live shoppers.
Frequently asked questions
Does it show anything to storefront visitors?
No. The storefront tracker is intentionally invisible. The value of the module lives in the OpenCart admin dashboard, not in any public visitor-facing widget.
Does this module store IP addresses or customer history?
No. The module tracks only short-lived anonymous presence data and coarse country or device summaries. It does not build persistent visitor histories.
Do I need Redis, WebSockets, or a Node.js process?
No. The module is designed to work with a standard OpenCart stack and short-lived file-backed runtime storage only.
Can I demonstrate the dashboard before launch or on staging?
Yes. Preview traffic mode injects sample visitors from the admin side so you can show the interface, take screenshots, or test the dashboard flow safely.
How often does the visitor count update?
The dashboard is heartbeat-based. Counts refresh on the configured interval, so the module stays light while still feeling close to real time.
Need live visitor insight without analytics overhead?
Built for OpenCart store owners who want immediate operational visibility and a native admin experience.
MIT · Developed by Devlin Duldulao