NAME

Apache2::WURFLFilter - The module detects the mobile device and passes the WURFL capabilities on to the other web application as environment variables

SYNOPSYS

The configuration of V2.x of "Apache Mobile Filter" is very simple thane V1.x, I have deprecated the intelliswitch method because I think that the filter is faster.

Add this parameter into httpd.conf file:

PerlSetEnv CapabilityList max_image_width,j2me_midp_2_0 *

PerlSetEnv WurflNetDownload true***

PerlSetEnv DownloadWurflURL http://downloads.sourceforge.net/wurfl/wurfl-latest.zip****

PerlSetEnv DownloadZipFile false

PerlSetEnv ResizeImageDirectory /transform

PerlSetEnv LoadWebPatch true

PerlSetEnv PatchWurflNetDownload true

PerlSetEnv PatchWurflUrl http://wurfl.sourceforge.net/web_browsers_patch.xml

PerlSetEnv MobileVersionUrl /cgi-bin/perl.html ** (default is "none" that mean the filter pass through)

PerlSetEnv FullBrowserUrl http://www.google.com ** (default is "none" that mean the filter pass through)

PerlSetEnv RedirectTranscoderUrl /transcoderpage.html (default is "none" that mean the filter pass through)

PerlSetEnv CookieCacheSystem true (default is false, but for production mode is suggested to set in true)

PerlModule Apache2::WURFLFilter

PerlTransHandler +Apache2::WURFLFilter

* the field separator of each capability you want to consider in your mobile site is ",". Important you now can set ALL (default value) if you want that the filter managed all wurfl capabilities

**if you put a relative url (for example "/path") the filter done an internal redirect, if you put a url redirect with protocol (for example "http:") the filter done a classic redirect

***if this parameter is fault the filter try to read the wurfl.xml file from MOBILE_HOME path

***if you want to download directly the last version of WURFL.xml you can set the url parameter to http://downloads.sourceforge.net/wurfl/wurfl-latest.zip

****if you put to true value you can detect a little bit more device, but for strange UA the method take a lot of time

DESCRIPTION

For this configuration you need to set this parameter

ConvertImage (boolean): activate/deactivate the adaptation of images to the device

ResizeImageDirectory: where the new images are saved for cache system, remember this directory must be into docroot directory and also must be writeble from the server

WurflNetDownload (boolean): if you want to download WURFL xml directly from WURFL site or from an intranet URL (good to have only single point of Wurfl access), default is set to false

DownloadWurflURL: the url of WURFL DB to download**

CapabilityList : is the capability value you want to pass to you site

MobileVersionUrl: is the URL address of mobile version site *

FullBrowserUrl: is the URL address of PC version site *

RedirectTranscoderURL: the URL where you want to redirect the transcoder*

LoadWebPatch (boolean): if you want to use a wurfl patch file

PatchWurflNetDownload(boolean): if you want download the patch file

PatchWurflUrl: the URL of the patch file (is readed ony if PatchWurflNet is setted with true)

*if you put a relative url (for example "/path") the filter done an internal redirect, if you put a url redirect with protocol (for example "http:") the filter done a classic redirect. If the parameter is not set the filter is a passthrough

**if you want to download directly the last version of WURFL.xml you can set the url parameter to http://downloads.sourceforge.net/wurfl/wurfl-latest.zip

*** for more info about transcoder problem go to http://wurfl.sourceforge.net

SEE ALSO

For more details: http://www.idelfuschini.it/apache-mobile-filter-v2x.html

Mobile Demo page of the filter: http://apachemobilefilter.nogoogle.it (thanks Ivan alias sigmund)

Demo page of the filter: http://apachemobilefilter.nogoogle.it/php_test.php (thanks Ivan alias sigmund)

AUTHOR

Idel Fuschini (idel.fuschini [at] gmail [dot] com)