meerware / browser-information
SilverStripe Module detecting browser information
Installs: 332
Dependents: 0
Suggesters: 0
Security: 0
Stars: 9
Watchers: 2
Forks: 1
Open Issues: 0
Type:silverstripe-module
Requires
This package is not auto-updated.
Last update: 2024-04-13 13:56:04 UTC
README
A small module for detecting the browser name, version, operating system and device type through the browser user agent and exposing methods for controllers.
Requirements
- SilverStripe 3 or higher
Usage
The module automatically extends all Controllers to have two methods:
$controller->getBrowser(); $controller->Browser();
Both returning a Browser class which wraps the browser name, version, operating system and device type.
Browser Name
$browser->getName();
The browser name is crude but will return one of the following:
- ie
- firefox
- chrome
- safari
- netscape
- opera
- konqueror
- unknown
Browser Version
$browser->getVersion();
The browser version will return a string value in the format of "X.X", just the major and minor version numbers if present.
Operating System
$browser->getSystem();
The operating system will return one of the following values:
- linux
- macintosh
- windows
- ios
- android
- unknown
Device
$browser->getDevice();
Device detects whether the browser is either a handheld or a screen device (mobile/tablet or desktop/laptop) and will return the following values:
- screen
- handheld
Engine
$browser->getEngine();
Detects the browser rendering engine and will return the following values:
- gecko
- webkit
- trident
- presto
Templates
When the module is included in your SilverStripe directory structure, the module, through extension, will expose a browser attribute for use in templates:
<html class="$Browser">
Will be evaluated to something like:
<html class="macintosh firefox firefox22 screen gecko">