README.txt 1.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546
  1. Browscap provides an improved version of PHP's get_browser() function.
  2. The get_browser() function can be used to tell what a visitor's browser is
  3. capable of. Unfortunately, the version provided by PHP has a number of
  4. limitations, namely:
  5. * It can be difficult or impossible to configure for shared hosting
  6. environments.
  7. * The data used to identify browsers and determine their capabilities requires
  8. consistent maintenance to keep up-to-date.
  9. Browscap automates maintenance by storing browser data in a database and
  10. automatically retrieving the latest data on a configurable schedule.
  11. Requirements
  12. ------------
  13. Browscap requires that your server be able to "phone out" (make a http request)
  14. to retrieve and update its user agent database.
  15. Note: Some hosting companies have this capability blocked.
  16. Installation
  17. ------------
  18. Browscap can be installed via the standard Drupal installation process.
  19. http://drupal.org/node/895232
  20. API
  21. ---
  22. Modules can make use of browscap data by calling browscap_get_browser()
  23. anywhere they would otherwise call the PHP get_browser()
  24. (http://us3.php.net/manual/en/function.get-browser.php) function.
  25. Note: browser_name_regex is not returned.
  26. Credits
  27. -------
  28. Development of Browscap is sponsored by Acquia (http://www.acquia.com) and the
  29. Ontario Ministry of Northern Development and Mines (http://www.mndm.gov.on.ca).
  30. A special thanks goes out to Gary Keith (http://www.garykeith.com) who provides
  31. regular updates to the browscap user agent database, and specifically for
  32. adding a non-zipped CSV version of browscap to support this module.