You are here

Home » API reference » Mobile Tools 6

README.txt in Mobile Tools 6

Same filename and directory in other branches
  1. 5 README.txt
  2. 6.3 README.txt
  3. 6.2 README.txt
  4. 7.3 README.txt
  5. 7.2 README.txt
README.txt
==========
The purpose of this module is to provide de Drupal developer with some tools that assist in making a site mobile.

Main functionalities are:

 - theme switching based on mobile device or device group
 - User notification (notify users of existence of mobile or desktop site)
 - User redirection (mobile user to the mobile site) 
 - Cookies to remember users preference (viewing mobile or desktop site)
 - Mobile permissions [experimental]
 - managing the number of displayed posts on the frontpage
 - using third party modules for device detection


CACHING
=======
Device detection and redirection works fine when caching is enabled. However if you choose to do theme switching based on device, caching will bypass the theme switching and get your pages out of cache:
e.g.: First user visits the site with his iphone and gets the iphone theme. The theme get's stored in cache, but the second user with a simple feature phone will also get the iphone theme.

Solution: Open the mobile_tools_cache.inc file and read the documentation!


AGGRESSIVE CACHING
==================
The Mobile Tools module does not support device detection when you use aggressive caching. 
Aggressive cachig bypasses any Drupal loading and by consequence the device detection system.

Recommended is to try user agent detection in your caching server and use a similar algorithm than 
the one used by Mobile Tools. 


AUTHOR/MAINTAINER
======================
Tom Deryckere
http://twitter.com/twom
http://www.mobiledrupal.com

File

README.txt
View source 
  1. README.txt

  2. ==========

  3. The purpose of this module is to provide de Drupal developer with some tools that assist in making a site mobile.

  4. 

  5. Main functionalities are:

  6. 

  7.  - theme switching based on mobile device or device group

  8.  - User notification (notify users of existence of mobile or desktop site)

  9.  - User redirection (mobile user to the mobile site) 

  10.  - Cookies to remember users preference (viewing mobile or desktop site)

  11.  - Mobile permissions [experimental]

  12.  - managing the number of displayed posts on the frontpage

  13.  - using third party modules for device detection

  14. 

  15. 

  16. CACHING

  17. =======

  18. Device detection and redirection works fine when caching is enabled. However if you choose to do theme switching based on device, caching will bypass the theme switching and get your pages out of cache:

  19. e.g.: First user visits the site with his iphone and gets the iphone theme. The theme get's stored in cache, but the second user with a simple feature phone will also get the iphone theme.

  20. 

  21. Solution: Open the mobile_tools_cache.inc file and read the documentation!

  22. 

  23. 

  24. AGGRESSIVE CACHING

  25. ==================

  26. The Mobile Tools module does not support device detection when you use aggressive caching. 

  27. Aggressive cachig bypasses any Drupal loading and by consequence the device detection system.

  28. 

  29. Recommended is to try user agent detection in your caching server and use a similar algorithm than 

  30. the one used by Mobile Tools. 

  31. 

  32. 

  33. AUTHOR/MAINTAINER

  34. ======================

  35. Tom Deryckere

  36. http://twitter.com/twom

  37. http://www.mobiledrupal.com