/ 
Apache2-WURFLFilter-2.04a
River stage zero No dependents
/ Apache2::WURFLFilter

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 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 WurflNetDownload true*** PerlSetEnv DownloadWurflURL http://downloads.sourceforge.net/wurfl/wurfl-latest.zip**** PerlSetEnv DownloadZipFile false PerlSetEnv ResizeImageDirectory /transform PerlSetEnv Log4WurflNoDeviceDetect /apache2_dev/WurflLog/DeviceNotFound.log PerlSetEnv LoadWebPatch true PerlSetEnv DirWebPatch /apache2_dev/Apache2/web_browsers_patch.xml PerlSetEnv PatchWurflNetDownload true PerlSetEnv PatchWurflUrl http://wurfl.sourceforge.net/web_browsers_patch.xml PerlSetEnv RedirectTranscoder true 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
DownloadZipFile (boolean): if you want to download a zip file of WURFL
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*
ConvertOnlyImages (boolean): if you want to use the filter only for the images and not for other content
Log4WurflNoDeviceDetect: it's a necessary log for detect new device that WURFL not has included
LoadWebPatch (boolean): if you want to use a wurfl patch file =item DirWebPatch: set it for indicate where is the patch file on your server
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)
DetectAccuracy: if you want to detect with more precision the devices (default is false), I suggest if it's not necessary to leave at false

*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

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