PK Q?aV V build.xml
PK B?Mi" " manifestversion=0.1
frameworkVersions=1.2
PK #?8 readme.md# UserAgentCheck module for the play framework
## What is UserAgentCheck ?
UserAgentCheck provides an easy way to notify users when their browser is outdated. It displays a non disruptive banner at the top of the page and drives the user to a page where he/she may download an upgrade.
![screenshot](https://github.com/orefalo/useragentcheck/raw/master/screenshot.png)
## How does it work ?
It's no rocket science: the module provides a tag than may be included in your templates (typically `main.html`). In a nutshell, the module reads the user-agent header, figures the browser name/version and decides, based on your settings, if the banner should be displayed.
To avoid redoing the same process on every request, it then stores the result in the session (which in Play translates to a cookie).
## Usage:
### Configuration
By using properties in `conf/application.conf` the developer has full control over when the banner should display.
useragentcheck.minInternetExplorerVersion = 7
useragentcheck.minOperaVersion = 10
useragentcheck.minFirefoxVersion = 5
useragentcheck.minChromeVersion = 13
useragentcheck.minSafariVersion = 5
With the sample lines above, the banner will show if you use IE6 or prior, Opera 9 or prior..etc
### Tag
You should include the `useragentcheck` tag somewhere in your template. Preferable right at the top of the html body.
…
#{useragentcheck /}
#{doLayout /}
...
### Banner settings
The banner text and url may be configured using the standard `conf/messages` file. The default entries are
useragentcheck.label=Your browser is no longer supported. Please click here to update...
useragentcheck.url=http://www.google.com/chrome
## Sample application
a sample demo is part of the distribution
## Credits
User Agent Utils - Harald Walker - [http://user-agent-utils.java.net/](http://user-agent-utils.java.net/)
play-useragentcheck module - Olivier Refalo - [https://github.com/orefalo](https://github.com/orefalo)
PK vT?]oN oN screenshot.pngPNG
IHDR r n :G] |iCCPICC Profile xYeXUMמOryNnED QZ
D0IETEDTLBPݠ>{}7kfͬ3{- `o!GD ESlty]xq 3dkks?q m7>ض?iwo7 5 VJ4 m{q۸ LAmc߸}{#;;=3
L@ z#vh| `Ew vO'44|"X_vdlcA4"B ;BCbڹX;uD
dC-0L1)
$xG!s ;PlpٶmNUF,pȦ1E8d
~{+"zۇmB,?}Dc}l sESϰ_ ~a݈5ͱlE >au9"/@^BW/-HAQ#0C@Fv?;_hm/!xcټt`XC_ QPv3CFb[Hba[{lvF߾Îg2gfZ-V@5КhfAs