Downloads

From Tera-WURFL

Revision as of 16:40, 7 June 2011

About

Tera-WURFL 2.1 does not include WALL4PHP. If you would like to use WALL4PHP with version 2.x, you must download the updated package below. This version is compatible with all versions of Tera-WURFL. To get WALL4PHP working with Tera-WURFL 2.x, download the latest WALL4PHP file from this site, then extract the ZIP archive wherever you like. If you extract it the same folder that the Tera-WURFL folder is in, you shouldn't have to update the WALL configuration. Otherwise, edit wall_prepend.php and change the path to the TeraWurfl.php file. You can find the full path to Tera-WURFL in the Tera-WURFL admin site under Statistics, Settings, Log File, then look for Installation Directory.

Documentation

You should start out by reading the README file. This file contains lots of important information, like installation.

Here are some important documentation links:

• Installation
• README
• Class Documentation
• Configuration File Documentation

You can also see the highlighted source code for all the files in the Class Documentation page.

Current Version

Development Version

The development versions of both Tera-WURFL and the Tera-WURFL maintained version of WALL4PHP are hosted on Steve Kamerman's GitHub account. Currently, all contributions are tested and verified locally before they are pushed to the repository, so they are normally consistent. If you would like to help improve Tera-WURFL, feel free to fork the master repo and submit a pull request so your changes can be merged in.

Tera-WURFL

TeraWurfl_2.1.5.zip (06 June 2011)
To upgrade to 2.1.4 you can copy the files directly over your existing installation. In version >= 2.1.4, the configuration file is included as an example only (TeraWurflConfig.php.example) and will not overwrite your existing config file. If you want to stay on the bleeding edge, you can also clone the GitHub repo and run "git fetch" whenever you want to update to the latest version of Tera-WURFL. Make sure to check out the Installation Guide!

WALL4PHP

UPDATED July 2, 2010 to support the Tera-WURFL Remote Webservice
This version of WALL4PHP has been modified for Tera-WURFL 2
WALL4PHP-1.1_Tera-Wurfl2_v1.2.zip (103KB, 02 July 2010)

Please see the Tera-WURFL WALL4PHP documentation for detailed installation instructions.

HAWHAW

This version of HAWHAW has been modified and optimized for Tera-WURFL 2
hawhaw_TeraWurfl2_v1.0.zip (40KB, 24 Feb 2010)

Version History

The complete commented commit history from 2.1.2 on is available on the GitHub repo.

Stable 2.1.5

Released 06 Jun 2011 Tera-WURFL is now part of ScientiaMobile

Stable 2.1.4

Released 21 Feb 2011

• Switched to better XML Parser (old parser, SimpleXML will still be used if XMLReader is missing)
• Improved matching for Apple, Android, Nokia, BlackBerry / RIM, DoCoMo, KDDI, LG and OperaMini
• Allowed preloading a custom TeraWurflConfig so the default is ignored
• Updated source documentation
• Updated instructions
• Greatly improved cmd_line_admin.php
• Converted line endings to \n
• Various bugfixes
• Improved Remote Client
• Added builtin regression testing (thanks digitalronin!). Tip: from the shell, go to the test/ dir and type "rake sanity" to make sure your patches are compatible with the loaded WURFL
• Moved default config to "TeraWurflConfig.php.example" so your config isn't overwritten
• Fixed MSSQL DB Connector bug

Stable 2.1.3

Released 18 Sep 2010

• Native support for MongoDB
• Better support and performance for Microsoft SQL Server
• Better webservice performance using JSON
• Better Python client with JSON support
• Improved performance in MySQL5
• Device Images are available via the PHP webservice client
• Loaded WURFL version is now tracked in the DB
• MySQL connector allows for alternate port
• Better overall detection

Stable 2.1.2

Released 14 May 2010

• Version 2.1.2 is the first 2.x version to support device images - check out the Device Image page for usage details.
• Improved detection of iPhone, iPod, iPad, DoCoMo devices and other international devices
• Webservice now includes an error log and access log
• Webservice includes support for JSON and uses it by default with the TeraWurflRemoteClient
• Fixed an issue with the PHP Remote Client that prevented the proper detection of some user agents
• Fixed various minor bugs and inconsistencies

Stable 2.1.1

Released 03 Mar 2010

• Added support for Firefox Mobile
• Increased speed and accuracy of Opera web browser detection
• Added full Remote Webservice and remote clients for PHP, JavaScript, Python, Perl and ActionScript
• Added User Agent problem submission form to Web Administration Page

Stable 2.1.0

Released 10 Feb 2010

• Performed deep analysis of the Tera-WURFL core and UserAgentMatchers and dramatically improved both performance and accuracy
• Introduced SimpleDesktop Matching Engine which increases detection speed for desktop browsers by 10x from version 2.0.0, while reducing the cache size by caching all desktop user agents in one cache entry
• Introduced Capability Filtering which allows you to increase performance and drastically cut the size of your database. Capability Filtering lets you decide which capabilities you want to use from the WURFL file and ignores the rest. For example, if you only want to use Tera-WURFL to redirect mobile visitors, you only need to use the is_wireless_device capability, so you can set CAPABILITY_FILTER = array("is_wireless_device"); and only that capability will be stored in the database, instead of the 500+ capabilities that normally exist
• Fixed bug that was preventing Firefox from being detected properly in some situations
• Fixed various other minor bugs and misspellings
• Optimized all UserAgentMatchers
• Optimized Tera-WURFL core and UserAgentFactory

Stable 2.0.0

Released 13 Nov 2009

• Cleaned up unecessary code
• Created MySQL4 Database Connector
• Improved MySQL5 Database Connector (40% faster initial detection)

NOTE: you need the CREATE PROCEDURE and EXECUTE permissions as of this release

• Tested many different methods to increase speed of initial detection
• Fixed numerous typos

Pre-Release 2.0.0 RC5

Released 01 Nov 2009 Spent a week sifting through 30,000 unique user agents over and over again while making adjustments to the UserAgentMatchers. The device detection is now extremely accurate. Not only will it detect mobile devices accurately, it is also very good at differentiating between wireless and non wireless devices. Here are the major changes:

• User Agent Matchers have been very finely tuned, re-ordered, removed and added to improve both performance and accuracy.
• PCRE Regular Expression Matching has been introduced to allow for greater flexibility and accuracy in UserAgentMatchers and the UserAgentFactory.
• Online WURFL Updating is back thanks to the ZipArchive package. This package is included with PHP >= 5.2.0. For previous versions of PHP it is available from PECL. As a last resort, Tera-WURFL will attempt to use gunzip to extract the WURFL file from the downloaded archive.
• User Agent Matcher History information is now available via TeraWurfl->capabilities['tera_wurfl']['matcher_history'] - this allows you to see the logic flow that went behind deciding which device this is. Here's an example:

User Agent: Alcatel-OT-280/1.0 model-orange ObigoInternetBrowser/Q03C Matcher History: AlcatelUserAgentMatcher(exact), AlcatelUserAgentMatcher(conclusive), AlcatelUserAgentMatcher(recovery), CatchAllUserAgentMatcher(recovery) This shows that the User Agent was assigned the Alcatel Matcher, but after looking for an exact match, a conclusive match and a recovery match, no match could be found - therefore the CatchAll Matcher was used to make a last-resort desicion.

• Performance VS. WURFL PHP API. I ran 23902 user agents through both Tera-WURFL and the new WURFL PHP API and here are the results (caching enabled on both, same wurfl.xml used):

Tera-WURFL Total Time: 12.081017971039 sec Devices Processed: 23902 Total Queries: 23912

WURFL PHP API Total Time: 217.57795381546 sec Devices Processed: 23902 Total Queries: N/A

As you can see, Tera-WURFL is still the best choice for accuracy and performance. Tera-WURFL may be even faster than these number indicate since the WURFL PHP API was benefiting greatly from my Samsung SSD.

Hardware used for testing: Dell Studio XPS Laptop, Core 2 Duo 2.8GHz, 4GB DDR2, 256GB Samsung SSD, Microsoft Windows 7 Ultimate x64, WampServer 2.0 (Apache 2.2.11, PHP 5.3.0, MySQL 5.1.36)

Pre-Release 2.0.0 RC4

Released 26 Oct 2009 Rewrote some of the UserAgentMatchers and deleted others to bring Tera-WURFL on par with the Java WURFL API. With the introduction of desktop browser UserAgentMatchers, we no longer need to use the large web patch; instead, you can just use the 8KB one from wurfl.sourceforge.net (included). Also, I fixed some typos and bugs here and there. NOTE: if you are upgrading from version 2.0.0 RC1-RC3 you should delete all your database tables before you update. You can leave the terawurflcache table if you want to retain your cache. Although it will still technically work even if you don't delete the tables, you will be orphaning some unecessary tables in your database.

Pre-Release 2.0.0 RC3

Released 20 Oct 2009 Complete code-rewrite from the ground up. The 2.x version of Tera-WURFL is loosely based on a pre-release of the Java WURFL Evolution Library, but the API is taken from Tera-WURFL 1.5.2. The following is a list of features found in Tera-WURFL 2.0:

• User Agent Matchers have been created for each of the major manufacturers. These allow for specific matching methods to be applied to the user agent like string searching, RIS (Reduction in String) and LD (Levenshtein Distance).
• Multiple patch files are now supported. Tera-WURFL ships with the current wurfl.xml, web_browsers_patch.xml and custom_web_patch.xml. Patch files can be added to TeraWurflConfig.php by separating them with semicolons in the TeraWurflConfig::PATCH_FILE directive. Patch files are loaded in order from left to right on top of the WURFL file, so if you want to override every other patch file, specify it last.
• The custom_web_patch.xml file can be edited from the Web Administration page, and allows you to easily add non-mobile user agents to the patch file. The devices with these user agents will be detected as generic_web_browser (non-mobile).
• Persistent Caching means that your cached devices stay cached. When you update the WURFL file or your patches, your device cache is also updated via the new database.
• Cache Browser allows you to see what devices are hitting your site and what their capabilities were detected as.
• Installation Script is better than 1.5.2. Once you download Tera-WURFL and extract it, edit TeraWurflConfig.php then go to /admin/install.php and follow the directions to finish installation.
• PHP short_open_tags are no longer required to run Tera-WURFL. PHP has this feature disabled by default now.
• Conclusive vs. Inconclusive Matching. If a device is matched with the UserAgentMatcher's primary matching method it is considered a conclusive match, if it is detected via a recovery matcher or by the CatchAllMatcher it is an inconclusive match. This information is available via the tera_wurfl capability group.
• tera_wurfl Capability Group. The TeraWurfl->Capabilities array now contains a group called "tera_wurfl". This group contains the following Tera-WURFL related information:
  • num_queries - the number of database queries required to lookup the device.
  • actual_root_device - the WURFL ID of the actual device (not subrevision or generic), this can be null.
  • match_type - either conclusive or inconclusive.
  • matcher - the name of the UserAgentMatcher that detected the device.
  • match - whether or not there was an actual match. If there was no match, Tera-WURFL guessed which generic device is most similar to the device.
  • lookup_time - the time in seconds that it took to detect the device.
  • fall_back_tree - the complete fallback tree that built the capabilities of the device. This is a list of all the WURFL IDs from the detected device down to the base generic device.

Stable 1.5.2

Released 27 July 2007

• Introduced a smart installation script to help you get Tera-WURFL up and running fast!

getDeviceCapabilitiesFromAgent() function now returns boolean true (match) or false (no match).

• Introduced "MATCH_TO_UA_PREFIX" if true, matching will stop if the user agent prefix cannot be matched. The user agent prefix is everything from the beginning of the UA to the first '/', like "SonyEricssonK700i". If this is not matched in the WURFL, there searching will stop.
• Introduced "RETURN_GENERIC" if true, the user agent and accept headers will be used to determine if this device iswireless or not and the capabilities array will be populated with appropriate generic data. This IS considered a match. Set this to false to stop getting generic matches.
• Introduced webservice.php which can be used to query the Tera-WURFL database via an HTTP request. The results are returned in XML. This is a BETA feature, but it is very safe. There are details and example in the head of the file.
• Re-wrote the README file - now it has very clear instructions on usage and installation.
• Now Tera-WURFL includes the web browsers patch by default so you can tell Mobile and Non-Mobile devices apart.
• Cleaned up some minor logging issues.
• Completely re-wrote the UA matching system, scrapping a lot of unnecessary code that was wasting time!

Stable 1.5.1

Released 09 May 2007 Fixed a bug that prevented the updating system from working correctly over the web.
If you have version 1.5.0 you can delete line 266 from the file tera_wurfl_parser.php and it will function the same as 1.5.1.

Stable 1.5.0

Released 27 Apr 2007

• Introduced a MySQL caching system - many thanks to Andrea Trasatti for his help!
• Fixed a PHP5 typecasting error while loading data in tera_wurfl_parser.php (thanks Mait Vilbiks and everyone else!)
• Fixed a PHP5 syntax error in the log_error() function (thanks Michal Albrecht!)
• Introduced a lite version that does not include the 800+ device images or the wurfl.xml file. This is only a 32k download and one it's installed you can update the wurfl.xml from the admin page.
• After much testing and some decent market penetration I have deemed this class "Stable".

Beta 1.4.4

Released 26 Dec 2006

• Completely rewrote the error logging system and verified it's operation after a bug was discovered (thanks Neil!)
• Added many features to the web administration console - seriously - check out the online demo!
• Changed default DATADIR to the included 'data' directory
• Completely rewrote the README file to include detailed installation instructions and other useful info
• Optimized the clean installation process - now Tera-WURFL has a brain!
• Included the current stable release of the wurfl.xml file so you don't need to download it
• Included database statistics, log file monitoring and global configuration in web interface
• Changed default log level to LOG_WARNING instead of LOG_ERR
• Described in great detail the purpose of the different database tables

Beta 1.4.3

Released 26 Dec 2006

• Updated the web administration interface and added some helpful links.
• Fixed a few relative path issues when including the class from a different directory.
• Fixed a couple problems with my naming convention and browser_is_wap detection (thanks MOLABIB!)

Beta 1.4.2

Released 16 Nov 2006

• Changed the web update URL for the wurfl.xml file.
• Made the file locations absolute instead of relative so you can run the class from a different directory
• Fixed an issue with the searching algorithm - thanks Christian Aune Thomassen! (WapTheWeb)

Beta 1.4.1

Released 27 Oct 2006 Fixed issues with incorrectly identified device root resulting in the wrong device image being used.

Beta 1.4.0

Released 27 Oct 2006 Added support for the Device Thumbnails by André van den Heever and Luca Passani.

Beta 1.3.0

Released 26 Oct 2006

• Added patching support to allow users to make changes to their WURFL database without editing the main WURFL.
• Added the ability to enable/disable the patch without rebuilding the database.
• Added a simple web administration utility to manage the WURFL and patch file.
• Added the ability to update the WURFL database directly from wurfl.sourceforge.net

Beta 1.2

Released 26 Oct 2006 Initial public release. Basic implementation of the library - very limited documentation included in comments.

Alpha2

Released 25 Oct 2006 Internal release. This is left on the site for historical reasons only. Use of this version is not recommended!