Pierre Lannoy

Hosterra

Device Detector is a full featured analytics reporting and management tool that detects all devices accessing your WordPress site.
For each call made to your site, Device Detector analyzes the sent header, detects the device doing the call (and its characteristics) and can:
<ul>
<li>modify the <code>is_mobile()</code> WordPress core function to be more precise and reliable;</li>
<li>add some CSS classes to the <code>body</code> tag of your site (many classes to choose from);</li>
<li>let you use the result of the detection in your own developments;</li>
<li>record detected characteristics for reporting.</li>
</ul>
Device Detector can report the following main items and characteristics:
<ul>
<li>KPIs: number of hits, class breakdown, clients types and engines;</li>
<li>Classes: Bot, Desktop, Mobile and Other;</li>
<li>Devices types: Camera, Car Browser, Console, Feature Phone, Phablet, Portable Media Player, Smart Display, Smartphone, Tablet, TV;</li>
<li>Client types: Application Library, Browser, Feed Reader, Media Player, Mobile Application, PIM.</li>
<li>Technical characteristics and versions of all browsers;</li>
<li>Device identification: brand, model, etc.;</li>
<li>OS identification: name, version, etc.;</li>
<li>Calling channel: site backend, site frontend, cron job, Ajax request, XML-RPC request, Rest API request, Atom/RDF/RSS feed;</li>
</ul>
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 supports an extensive set of WP-CLI commands to:
<ul>
<li>get a device detail: see <code>wp help device describe</code> for details;</li>
<li>display Device Detector status: see <code>wp help device status</code> for details;</li>
<li>toggle on/off main settings: see <code>wp help device settings</code> for details;</li>
<li>describe engine capacities: see <code>wp help device engine</code> for details;</li>
<li>display devices statistics: see <code>wp help device analytics</code> for details.</li>
</ul>
For a full help on WP-CLI commands in Device Detector, please <a href="https://perfops.one/device-detector-wpcli" rel="nofollow ugc">read this guide</a>.
<blockquote>
Device Detector is part of <a href="https://perfops.one/" rel="nofollow ugc">PerfOps One</a>, a suite of free and open source WordPress plugins dedicated to observability and operations performance.
</blockquote>
Based on the amazing <a href="https://github.com/matomo-org/matomo" rel="nofollow ugc">Matomo</a> 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.
<h4>Developers</h4>
If you’re a plugins / themes developer and want to take advantage of the detection features of Device Detector, visit the <a href="https://github.com/Pierre-Lannoy/wp-device-detector" rel="nofollow ugc">GitHub repository</a> of the plugin to learn how to use it.
<h4>Support</h4>
This plugin is free and provided without warranty of any kind. Use it at your own risk, I’m not responsible for any improper use of this plugin, nor for any damage it might cause to your site. Always backup all your data before installing a new plugin.
Anyway, I’ll be glad to help you if you encounter issues when using this plugin. Please read carefully the FAQ at the bottom of this page before requesting support.
<h4>Privacy</h4>
This plugin, as any piece of software, is neither compliant nor non-compliant with privacy laws and regulations. It is your responsibility to use it – by activating the corresponding options or services – with respect for the personal data of your users and applicable laws.
This plugin doesn’t set any cookie in the user’s browser.
This plugin may handle personally identifiable information (PII). If the GDPR or CCPA or similar regulation applies to your case, you must adapt your processes (consent management, security measure, treatment register, etc.).
<h4>Donation</h4>
If you like this plugin or find it useful and want to thank me for the work done, please consider making a donation to <a href="https://www.laquadrature.net/en" rel="nofollow ugc">La Quadrature Du Net</a> or the <a href="https://www.eff.org/" rel="nofollow ugc">Electronic Frontier Foundation</a> which are advocacy groups defending the rights and freedoms of citizens on the Internet. By supporting them, you help the daily actions they perform to defend our fundamental freedoms!

Device Detector

good plugin

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

Tubal

A lightweight detector of mobile devices, OSs & browsers that, optionally, allows your site to switch to a mobile theme when a mobile device is detected or when your users feel like it.
This plugin adds the class MobileDTS to WordPress.
<h4>Mobile Detection</h4>
On every request, this plugin will try to detect if the user is viewing your site with a mobile device or not. If he is, the detector will also give you some info about the device, browser and OS used.
Who will be happy with this detector?
If you need a fast and reliable way to detect if a user is visiting your site with a mobile device, then you’ll be happy. However, if you need precise information about the device used (other than OS and browser) such as screen resolution you need a detector such as <a href="http://deviceatlas.com/" rel="nofollow ugc">DeviceAtlas</a> or <a href="http://wurfl.sourceforge.net/" rel="nofollow ugc">WURFL</a>.
How to query the detector?
Use the method <code>MobileDTS::is($key)</code>. <code>is()</code> returns boolean <code>true</code> or <code>false</code>.
Example:
<pre><code><?php

if (MobileDTS::is('android')) {
 // User with a mobile device running Android OS
} else if (MobileDTS::is('ios')) {
 // User with a mobile device running iOS
} else if (MobileDTS::is('mobile')) {
 // User with a mobile device (any, even 10 years old mobile phones) 
} else {
 // User with a desktop device 
}

?>
</code></pre>
Available keys:
<ul>
<li><code>mobile</code> (Is it a mobile?)</li>
<li><code>other</code> (Any other mobile device)</li>
</ul>
Popular mobile devices
<ul>
<li><code>iphone</code> (Apple iPhone)</li>
<li><code>ipad</code> (Apple iPad)</li>
<li><code>kindle</code> (Amazon Kindle)</li>
</ul>
Mobile OS
<ul>
<li><code>android</code> (Android OS)</li>
<li><code>bada</code> (Bada OS)</li>
<li><code>bbos</code> (Blackberry OS)</li>
<li><code>ios</code> (Apple iOS)</li>
<li><code>palmos</code> (Palm OS)</li>
<li><code>symbian</code> (Symbian OS)</li>
<li><code>webos</code> (Hp WebOS)</li>
<li><code>windows</code> (Windows Phone OS and older)</li>
</ul>
Mobile browsers
<ul>
<li><code>ff_mobile</code> (Mozilla Fennec & Firefox mobile)</li>
<li><code>ie_mobile</code> (IE mobile)</li>
<li><code>netfront</code> (NetFront)</li>
<li><code>opera_mobile</code> (Opera Mobile or Mini)</li>
<li><code>uc_browser</code> (UC Browser)</li>
<li><code>webkit_mobile</code> (Webkit mobile)</li>
</ul>
<h4>Theme Switching</h4>
You can configure your site to automatically switch to a mobile theme when a mobile device is detected or when the user requests it (on demand).
Once the plugin is installed, a new submenu titled <code>Mobile Detector</code> is added under the <code>Settings</code> menu.
Theme switching is disabled by default. To enable theme switching simply select a theme to use as your mobile theme and the plugin will take care of the rest.
This plugin assumes your active theme is optimized for desktop screens only. So, if you’re using a responsive theme that adapts to any screen size you shouldn’t use the theme switching feature (don’t select a theme).
How it works:
<ul>
<li>On each page load, this plugin checks for the existence of a cookie that stores which theme (mobile-optimized or desktop-optimized) the user prefers to browse.</li>
<li>If the cookie exists, the theme the user expects will be displayed.</li>
<li>If the cookie does not exist (first-time visitor), this plugin checks whether the user is visiting your site with a mobile device or not and, if he is, your mobile-optimized theme will be used. Afterwards, a cookie will be set to store the user’s “initial preference”.</li>
<li>Anytime the user switches (you must create a link/button in your theme using the Template functions below) between themes, the cookie is updated with his preference so the site version (theme) the user expects will be displayed on future visits.</li>
</ul>
Template functions
<ul>
<li>
<code>MobileDTS::get_switch_theme_link()</code> Returns the current URL with an additional <code>switch_theme</code> parameter (set automatically to ‘mobile’ or ‘desktop’). You’ll need this function to create a link/button that allows users to switch between the desktop and mobile themes. See example below.
</li>
<li>
<code>MobileDTS::switch_theme_link()</code>: same as above but this one outputs the URL instead of returning it. URL is escaped.
</li>
<li>
<code>MobileDTS::get_switch_theme_name()</code> returns the type of the theme to switch to (either ‘mobile’ or ‘desktop’). Use this method together with <code>get_switch_theme_link()</code>. The type can be translated to your language (plugin uses wp’s <code>__()</code> function for ‘mobile’ & ‘desktop’ strings).
</li>
<li>
<code>MobileDTS::switch_theme_name()</code> same as above but this one outputs the type instead of returning it.
</li>
<li>
<code>MobileDTS::is_mobile_theme()</code> tells you wether your site is displaying to the user the mobile theme or not. Returns boolean <code>true</code> or <code>false</code>.
</li>
<li>
<code>MobileDTS::is_switcher_enabled()</code> tells you wether theme switching is disabled or not. Returns boolean <code>true</code> or <code>false</code>.
</li>
</ul>
Creating a ‘Switch to …’ link
Let’s create a switch link to allow the user to switch between the 2 versions of a site (themes):
<pre><code><?php if (MobileDTS::is_switcher_enabled()): // Optional but useful if you need to disable theme switching for a while. ?>

<a href="<?php MobileDTS::switch_theme_link() ?>">Switch to the <?php MobileDTS::switch_theme_name() ?> version of this site</a>

<?php endif; ?>
</code></pre>
Paste that code in your templates (usually in <code>header.php</code> and/or <code>footer.php</code>), enable theme switching and play a little.
Let’s suppose a user is viewing the site (http://example.com/home) for the first time with a mobile device and theme switching is enabled. The above code would output this link:
<pre><code><a href="http://example.com/home?switch_theme=desktop">Switch to the desktop version of this site</a>
</code></pre>

Mobile Detector

Nice and Simple

Lightweight detector of mobile devices, OSs & browsers. Optionally a mobile theme switcher.

Device Detector vs Mobile Detector