Idel Fuschini > Apache2-WURFLFilter-2.21 > Apache2::WURFLFilter

Download:
Apache2-WURFLFilter-2.21.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  1
View/Report Bugs
Module Version: 2.21   Source  

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)

syntax highlighting: