bugbuster/mobiledetection

Contao helper class for detecting mobile phones and tablets (device type). A Hook adds a CSS class in the body tag.

Tuesday, October 28, 2014
by BugBuster
Repository
3 Watchers
2 Stars
124 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
1 Open issues
7 Versions
2 % Grown

The README.md

Contao Module MobileDetection

, _(*1)

About

Contao 3 Module "Mobile-Detection", based on "http://mobiledetect.net/", _(*2)

Helperclasses for developer. Demo frontend module is present., _(*3)

Installation

Manually

Do not use the ZIP file from GitHub! Use the ER2 mobiledetection

Over Composer

Search for bugbuster/mobiledetection, version >= 3.5
composer loads additionally "mobiledetect/mobiledetectlib" version 2.*

Hooks help!

A Hook add a special class to page css class (in body tag):, _(*4)

phone : mobile device, but no tablet
tablet : mobile device and a tablet
computer : no mobile device, no tablet

Examples

Galaxy S II (Phone), _(*5)

<body id="top" class="android safari webkit sf4 mobile phone">

Motorola Xoom (Tablet), _(*6)

<body id="top" class="android safari webkit sf3 mobile tablet">

Linux Mint PC (Computer), _(*7)

<body id="top" class="unix firefox gecko fx18 computer">

Usage the Classes

You have two options:, _(*8)

You're using the original class (Detection\MobileDetect).
You're using the wrapper class (MobileDetection\Mobile_Detection).

Mobile_Detect (original class)

ER2 version (without a namespace of the original class)

include '<path>/Mobile_Detect.php';

$detect = new Mobile_Detect();

Continue as described in the next section., _(*9)

Composer version (with a namespace of the original class)

use Detection\MobileDetect;

$detect = new MobileDetect(); 

// Check for any mobile device.
if ($detect->isMobile())

// Check for any tablet.
if($detect->isTablet())

// Check for any mobile device, excluding tablets.
if ($detect->isMobile() && !$detect->isTablet())

For the full list of available methods check the directory examples ., _(*10)

Mobile_Detection (wrapper class)

$this->import('\MobileDetection\Mobile_Detection','Mobile_Detection');

// Check device type
echo $this->Mobile_Detection->getDeviceType(); // phone|tablet|computer

// Check for any mobile device.
if ($this->Mobile_Detection->isMobile())

// Check for any tablet.
if ($this->Mobile_Detection->isTablet())

// Check mobile grade
echo $this->Mobile_Detection->getMobileGrade(); // A|B|C

// Check mobile rules
$arrRules = $this->Mobile_Detection->getMobileRules(); 
// result e.g. array('SamsungTablet','AndroidOS','Safari')

See demo module "MobileDetectionDemo"., _(*11)