DeviceChecker for WooCommerce

By reztart

0+ active installationsVersion 1.0.0

Device breakdown (Mobile / Tablet / Desktop) for WooCommerce orders and customers. Dashboard widget plus two reports. HPOS-compatible.

Description

Your WordPress + WooCommerce admin currently shows you the customer’s IP but no idea whether they ordered from a phone in a train station or a laptop at their desk. DeviceChecker fills that gap in every list you already look at — zero configuration, no external services, no fingerprinting.

What you get

  • Orders list — sortable Device column (HPOS + legacy CPT), tooltip with browser + OS
  • Users list — sortable Device column, populated on registration
  • Dashboard widget — Mobile / Tablet / Desktop split for Orders and registered Customers
  • WooCommerce → Reports — two new device breakdown reports (Orders and Customers) with date-range grouping (day / week / month / year)

How detection works

Prioritized:

  1. Sec-CH-UA-Mobile client hint (strongest signal from Chromium browsers)
  2. Optional Mobile_Detect library, if vendored into includes/
  3. Curated built-in regex covering ~99% of real-world traffic
  4. Tablet cross-check: iPad / Android tablet / Kindle Fire / Windows tablet

Browser + OS extracted for tooltips (Chrome 120, iOS 17, etc.). Fully User-Agent-based — no cookies, no fingerprinting, no third-party calls.

HPOS compatibility

Fully compatible with WooCommerce’s High-Performance Order Storage. Uses the WC_Order abstraction throughout — no direct wp_posts queries. Column hooks registered for both the legacy CPT screen and the new HPOS orders screen.

What it does NOT do

  • Does not track individual users across sessions (no fingerprinting)
  • Does not send any data outside your store — no external API, no analytics beacon
  • Does not backfill device info for users that registered before install; orders always work retroactively via WooCommerce’s native _customer_user_agent meta
  • Does not classify bots as a separate category (they render as Desktop with an empty browser tooltip)

Requirements

  • WordPress 6.5+ (uses the Requires Plugins header)
  • WooCommerce 8.0+ (both HPOS and legacy CPT storage supported)
  • PHP 7.4+ (tested up to 8.3)

Installation

  1. Plugins → Add New → Upload Plugin → choose devicechecker-for-woocommerce.zip → Install → Activate
  2. Configure at WooCommerce → Settings → DeviceChecker tab (all sections enabled by default)
  3. Look for the Device column in WooCommerce → Orders and Users → All Users

FAQ

Does this slow down my admin?

No. Each list column uses the User-Agent already stored by WooCommerce; detection is pure PHP regex without external calls. The dashboard widget queries at most 500 recent orders.

Does this work with headless / decoupled setups?

If your storefront places orders via REST or Store API and sends a real User-Agent, yes. If your headless client suppresses the UA header, those rows will show as “Unknown”.

Is this GDPR compliant?

Yes. Stores the User-Agent (not PII on its own) alongside the user_id or IP that WooCommerce already stores. No fingerprinting, no cookies, no external services.

What happens on uninstall?

Deactivating leaves everything. Deleting removes plugin options; the companion table is preserved by default. Define DEVICE_DETECTOR_HARD_UNINSTALL as true in wp-config.php before deletion to drop the table too.

Screenshots

Changelog

1.0.0

  • Initial release
  • Orders list Device column (HPOS + legacy CPT)
  • Users list Device column with sort support
  • Dashboard summary widget
  • Order Device Report + Customer Device Report under WC → Reports
  • Settings tab under WC → Settings → DeviceChecker