Title: Devlin Geo Pulse
Author: devlinduldulao
Published: <strong>26 مارس، 2026</strong>
Last modified: 12 أبريل، 2026

---

البحث عن الإضافات

![](https://ps.w.org/devlin-geo-pulse/assets/banner-772x250.png?rev=3493204)

![](https://ps.w.org/devlin-geo-pulse/assets/icon-256x256.png?rev=3493199)

# Devlin Geo Pulse

 بواسطة [devlinduldulao](https://profiles.wordpress.org/devlinduldulao/)

[تنزيل](https://downloads.wordpress.org/plugin/devlin-geo-pulse.1.0.6.zip)

 * [تفاصيل](https://ar.wordpress.org/plugins/devlin-geo-pulse/#description)
 * [المراجعات](https://ar.wordpress.org/plugins/devlin-geo-pulse/#reviews)
 *  [التنصيب](https://ar.wordpress.org/plugins/devlin-geo-pulse/#installation)
 * [التطوير](https://ar.wordpress.org/plugins/devlin-geo-pulse/#developers)

 [الدعم](https://wordpress.org/support/plugin/devlin-geo-pulse/)

## الوصف

Devlin Geo Pulse helps merchants understand current storefront activity in real 
time while keeping the data model intentionally minimal and privacy-first.

What it does:

 * Anonymous storefront heartbeat tracking
 * Active visitor count in WooCommerce admin
 * Ranked country pulse view for active visitors
 * Compact device-mix snapshot for the live heartbeat window
 * Top country and new-visitors-last-minute metrics
 * WordPress Dashboard widget for at-a-glance live metrics without leaving the main
   Dashboard
 * Admin toolbar live visitor indicator visible from every admin page
 * WooCommerce dashboard page under **WooCommerce > Live Geo Pulse**
 * WooCommerce settings tab under **WooCommerce > Settings > Devlin Geo Pulse**
 * Privacy-first storage using short-lived active presence only
 * WooCommerce settings for enabling tracking and adjusting heartbeat cadence

Privacy guardrails:

 * No raw IP addresses are stored
 * No personally identifiable information is stored
 * No persistent visitor history is retained
 * Presence data expires automatically when heartbeats stop

How it works:

 1. A lightweight frontend script sends anonymous heartbeat requests from the storefront.
 2. The plugin derives a coarse country code and device bucket from request metadata.
 3. Active presence is stored only in short-lived cache/transient state.
 4. The WooCommerce admin dashboard polls a summary endpoint for live updates.

The admin dashboard can optionally expose a preview traffic control that creates
short-lived sample visitors so the UI can be previewed without opening multiple 
storefront tabs.

The merchant dashboard uses native WordPress and WooCommerce admin patterns so the
interface feels familiar inside a standard store management workflow.

## لقطات الشاشة

 * [[
 * WooCommerce live dashboard with active visitor metrics, ranked country pulse,
   and device mix.
 * [[
 * WooCommerce settings screen for tracking, heartbeat interval, and privacy notice
   configuration.

## التنصيب

 1. Upload the plugin folder to `/wp-content/plugins/`, or install it through your 
    deployment workflow.
 2. Make sure WooCommerce is installed and active.
 3. Activate **Devlin Geo Pulse** in **Plugins**.
 4. Go to **WooCommerce > Live Geo Pulse** to view the dashboard.
 5. Go to **WooCommerce > Settings > Devlin Geo Pulse** to configure heartbeat settings.

If an earlier local build failed with `Class "WC_Settings_Page" not found`, replace
that copy with the current plugin files before activating again. The current release
registers its WooCommerce settings tab lazily so activation no longer depends on
WooCommerce having already loaded its admin settings base class.

## الأسئلة المتكررّة

### Does this plugin store IP addresses?

No. The plugin is designed to avoid storing raw IP addresses.

### Does this plugin keep a visitor history?

No. It stores only short-lived active presence state for the current live window.

### Does this plugin store personal data?

No. The plugin is designed to avoid storing personally identifiable information 
and uses only short-lived anonymous presence state.

### Does it require WooCommerce?

Yes. WooCommerce must be installed and active.

### How does the plugin determine country?

The plugin derives a coarse country code server-side from request metadata and does
not store raw IP addresses.

### What if activation previously triggered a critical error?

Update to the latest plugin files, ensure WooCommerce is active first, then reactivate
the plugin. If WordPress entered Recovery Mode, deactivate the broken copy before
reactivating the updated one.

### Can I simulate visits just to preview the dashboard UI?

Yes. The dashboard can expose a preview traffic control for WooCommerce managers.
It creates short-lived sample visitors for previewing the admin UI and clearly does
not represent real shoppers.

## المراجعات

لا توجد مراجعات لهذه الإضافة.

## المساهمون والمطوّرون

“Devlin Geo Pulse” هو برنامج مفتوح المصدر. وقد ساهم هؤلاء الأشخاص بالأسفل في هذه
الإضافة.

المساهمون

 *   [ devlinduldulao ](https://profiles.wordpress.org/devlinduldulao/)

[ترجمة ”Devlin Geo Pulse“ إلى لغتك.](https://translate.wordpress.org/projects/wp-plugins/devlin-geo-pulse)

### مُهتم بالتطوير؟

[تصفّح الشفرة](https://plugins.trac.wordpress.org/browser/devlin-geo-pulse/)، تحقق
من [مستودع SVN](https://plugins.svn.wordpress.org/devlin-geo-pulse/)، أو الاشتراك
في [سجل التطوير](https://plugins.trac.wordpress.org/log/devlin-geo-pulse/) بواسطة
[RSS](https://plugins.trac.wordpress.org/log/devlin-geo-pulse/?limit=100&mode=stop_on_copy&format=rss).

## سجل التغييرات

#### 1.0.5

 * Added a WordPress Dashboard widget with live visitor count, countries, and top
   country visible on the main Dashboard home page.
 * Added an admin toolbar indicator showing a live visitor count from every admin
   page.
 * Added a dismissible Getting Started onboarding guide on the Live Geo Pulse dashboard.
 * Added a permanent How It Works sidebar section explaining heartbeat tracking,
   dashboard, widget, and toolbar.

#### 1.0.4

 * Replaced the public heartbeat route `__return_true` callback with a dedicated
   permission callback that verifies the presence nonce at route permission time.
 * Normalized the remaining transient key prefix to `devlin_geo_pulse_` for better
   uniqueness and consistency.
 * Refreshed release metadata and regenerated the WordPress.org submission package
   for the approved `devlin-geo-pulse` slug.

#### 1.0.3

 * Refreshed the pending review submission package after the native WordPress/WooCommerce
   admin redesign and security-focused hardening work.
 * Expanded unit coverage for environment helpers, country/device resolvers, WooCommerce
   settings fields, presence storage, and data helpers.
 * Hardened GitHub Actions validation, packaging, and WordPress.org deployment workflows.

#### 1.0.2

 * Added explicit admin REST nonce verification for dashboard summary and preview
   traffic actions.
 * Hardened the submission package for WordPress.org review by excluding hidden 
   placeholder files and dev-only artifacts.
 * Updated WordPress compatibility metadata to `Tested up to: 6.9`.

#### 1.0.0

 * Added a preview traffic tool for store owners who want to demonstrate the live
   dashboard with short-lived sample visitors.
 * Fixed activation safety for WooCommerce settings registration by lazy-loading
   the settings page only after `WC_Settings_Page` is available.
 * Initial public release of Devlin Geo Pulse.
 * Added privacy-first live visitor presence tracking for WooCommerce storefronts.
 * Added WooCommerce admin dashboard metrics for active visitors and country distribution.
 * Added anonymous frontend heartbeat tracking with short-lived active-state storage.
 * Added WooCommerce settings for tracking, heartbeat interval, and privacy notice
   copy.

## ميتا Meta

 *  Version **1.0.6**
 *  Last updated **قبل 7 أيام**
 *  Active installations **أقل من 10**
 *  WordPress version ** 6.4 أو أعلى **
 *  Tested up to **6.9.4**
 *  PHP version ** 8.2 أو أعلى **
 *  Language
 * [English (US)](https://wordpress.org/plugins/devlin-geo-pulse/)
 * Tags
 * [analytics](https://ar.wordpress.org/plugins/tags/analytics/)[geolocation](https://ar.wordpress.org/plugins/tags/geolocation/)
   [live visitors](https://ar.wordpress.org/plugins/tags/live-visitors/)[privacy](https://ar.wordpress.org/plugins/tags/privacy/)
   [woocommerce](https://ar.wordpress.org/plugins/tags/woocommerce/)
 *  [عرض متقدم](https://ar.wordpress.org/plugins/devlin-geo-pulse/advanced/)

## التقييم

لم يتم تقديم أي مراجعات بعد.

[Your review](https://wordpress.org/support/plugin/devlin-geo-pulse/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/devlin-geo-pulse/reviews/)

## المساهمون

 *   [ devlinduldulao ](https://profiles.wordpress.org/devlinduldulao/)

## الدعم

لديك شيء لتقوله؟ بحاجة الى مساعدة؟

 [عرض منتدى الدعم](https://wordpress.org/support/plugin/devlin-geo-pulse/)