bugbuster / mobiledetection
Contao helper class for detecting mobile phones and tablets (device type). A Hook adds a CSS class in the body tag.
Installs: 139
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 3
Forks: 0
Open Issues: 1
Type:contao-module
Requires
- php: >=5.3
- contao-community-alliance/composer-plugin: *
- contao/core: >=3,<4
- mobiledetect/mobiledetectlib: 2.*
Replaces
- contao-legacy/mobiledetection: 3.5.0
This package is auto-updated.
Last update: 2024-11-23 10:23:33 UTC
README
About
Contao 3 Module "Mobile-Detection", based on "http://mobiledetect.net/"
Helperclasses for developer. Demo frontend module is present.
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):
- phone : mobile device, but no tablet
- tablet : mobile device and a tablet
- computer : no mobile device, no tablet
Examples
Galaxy S II (Phone)
<body id="top" class="android safari webkit sf4 mobile phone">
Motorola Xoom (Tablet)
<body id="top" class="android safari webkit sf3 mobile tablet">
Linux Mint PC (Computer)
<body id="top" class="unix firefox gecko fx18 computer">
Usage the Classes
You have two options:
- 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.
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 .
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".