DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Multi-channel contexts: WURFL¶

Provides context filters based on user device properties.

Allows you to show pages and content elements specifically for mobile devices, tablet or for different screen sizes.

It has the following device detection features:

Mobile devices yes/no
Wireless/tablet/phone/smart TV yes/no
Screen size range
Device brand name
Browser used

Installation¶

Dependencies¶

Contexts TYPO3 extension
MySQL5 (the PHP MySQLi extension is required).

Setup¶

Activate extension
Optional: Update the URL to the compressed WURFL archive - Currently used: http://sourceforge.net/projects/wurfl/files/WURFL/2.3.3/wurfl-2.3.3.zip/download
Go to "Admin tools" => "WURFL" and perform initial setup

Alternative way¶

Create backend user _cli_contexts_wurfl (for command line access)

Import WURFL database:

$ php ./typo3/cli_dispatch.phpsh contexts_wurfl import --type=remote

Setup a scheduler task to regularly update the WURFL database. It's sufficient to do this once a month or once a week, since it gets updated only a couple of times a year.

Usage¶

Context creation¶

Go to the TYPO3 web list view, root page (ID 0)
Create a new database record
Record type: Context
Give it a title, e.g. Type: tablet
Context type: Device properties
Check the "Tablet" check box.
Save

You now have a context that's active whenever a visitor views your page on a tablet.

WURFL¶

WURFL, the Wireless Universal Resource FiLe, is a Device Description Repository (DDR), i.e. a software component that maps HTTP Request headers to the profile of the HTTP client (Desktop, Mobile Device, Tablet, etc.) that issued the request.

See http://wurfl.sourceforge.net/ for more information.

Admintool¶

The WURFL contexts extension comes with an additional backend module located at Admin tools => WURFL.

The module allows you to easily update your existing WURFL database, clearing and rebuilding the WURFL cache and to perform test queries against the database.

Remote database update¶

You may either use the WURFL admintool or a scheduler task to update the WURFL database. Alternatively you could also use the CLI to fetch new data from the WURLF website.

See the setup section.

Local database update¶

Download a local version of the WURFL repository file.
Store it in /typo3temp/contexts_wurfl/wurfl.xml.

Call the contexts_wurl CLI task then:

$ php ./typo3/cli_dispatch.phpsh contexts_wurfl import --type=local

API update¶

When updating the WURFL PHP API, it is important to keep our version of Library/wurfl-dbapi-1.4.4.0/TeraWurflConfig.php. It contains the connection to TYPO3.