/wp-device-detector

Full featured analytics reporting and management tool that detects all devices accessing your WordPress site.

Primary LanguagePHPGNU General Public License v3.0GPL-3.0

Device Detector

version php wordpress license

Device Detector is a full featured analytics reporting and management tool that detects all devices accessing your WordPress site.

See WordPress directory page or official website.

For each call made to your site, Device Detector analyzes the sent header, detects the device doing the call (and its characteristics) and can:

  • modify the is_mobile() WordPress core function to be more precise and reliable;
  • add some CSS classes to the body tag of your site (many classes to choose from);
  • let you use the result of the detection in your own developments;
  • record detected characteristics for reporting.

Device Detector can report the following main items and characteristics:

  • KPIs: number of hits, class breakdown, clients types and engines;
  • Classes: Bot, Desktop, Mobile and Other;
  • Devices types: Camera, Car Browser, Console, Feature Phone, Phablet, Portable Media Player, Smart Display, Smartphone, Tablet, TV;
  • Client types: Application Library, Browser, Feed Reader, Media Player, Mobile Application, PIM.
  • Technical characteristics and versions of all browsers;
  • Device identification: brand, model, etc.;
  • OS identification: name, version, etc.;
  • Calling channel: site backend, site frontend, cron job, Ajax request, XML-RPC request, Rest API request, Atom/RDF/RSS feed;

For a full list of items, characteristics and supported devices, please see the 'devices' tab in the plugin settings.

Device Detector supports multisite report delegation and per site configuration (see FAQ).

Device Detector is part of PerfOps One, a suite of free and open source WordPress plugins dedicated to observability and operations performance.

The development of The PerfOps One plugins suite is sponsored by Hosterra - Ethical & Sustainable Internet Hosting.

Based on the amazing Matomo UDD, Device Detector is a free and open source plugin for WordPress. It integrates many other free and open source works (as-is or modified). Please, see 'about' tab in the plugin settings to see the details.

WP-CLI

Device Detector implements a set of WP-CLI commands. For a full help on these commands, please read this guide.

Hooks

Device Detector introduces some filters and actions to allow plugin customization. Please, read the hooks reference to learn more about them.

Installation

  1. From your WordPress dashboard, visit Plugins | Add New.
  2. Search for 'Device Detector'.
  3. Click on the 'Install Now' button.

You can now activate Device Detector from your Plugins page.

Support

For any technical issue, or to suggest new idea or feature, please use GitHub issues tracker. Before submitting an issue, please read the contribution guidelines.

Alternatively, if you have usage questions, you can open a discussion on the WordPress support page.

Contributing

Device Detector lets you use its detection features inside your own plugins or themes. To understand how it works and how to use it, please read the developer documentation.

Before submitting an issue or a pull request, please read the contribution guidelines.

⚠️ The master branch is the current development state of the plugin. If you want a stable, production-ready version, please pick the last official release.

Smoke tests

WP compatibility PHP compatibility