bugbuster/contao-mobiledetection-bundle

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

Wednesday, February 14, 2018
by BugBuster
Repository
1 Watchers
0 Stars
68 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
3 Versions
143 % Grown

Contao 4 Bundle "Mobile-Detection"

, _(*1)

, _(*2)

About

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

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

Installation

With Contao Manager

Search for bugbuster/contao-mobiledetection-bundle
Composer loads additionally "mobiledetect/mobiledetectlib" version 2.*

With Composer

composer require bugbuster/contao-mobiledetection-bundle
Composer loads additionally "mobiledetect/mobiledetectlib" version 2.*

Hooks help!

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

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

Examples

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

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

Motorola Xoom (Tablet), _(*7)

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

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

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

Usage the Classes

You have two options:, _(*9)

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

Mobile_Detect (original class)

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)

use BugBuster\MobileDetection\Mobile_Detection;
...
$this->Mobile_Detection = new 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)