Difference between revisions of "AppSuite:Browserdetection"

 
Line 1: Line 1:
<!-- !!! -->
+
The content on this page has moved to https://documentation.open-xchange.com/latest/ui/how-to/browser-detection.html
<!-- PLEASE APPLY CHANGES ONLY TO THE NEW TECHNICAL DOCUMENTATION: wd/frontend/web/documentation -->
 
<!-- !!! -->
 
  
== Browser detection outside AppSuite ==
+
Note: Open-Xchange is in the process of migrating all its technical documentation to a new and improved documentation system (documentation.open-xchange.com). Please note as the migration takes place more information will be available on the new system and less on this system. Thank you for your understanding during this period of transition.
[[File:loginpage.png|thumb|250px|This warning is not shown to a user if you use the form-login]]
 
 
 
AppSuite detects the client browser and collects some information about the current device the visitor is using. This information is used to serve the appropriate UI and enable/disable certain features for the visitor's device.  
 
 
 
The browser detection is done by a standalone, dependency free lib that can be included via script-tag to other sites. The original AppSuite login page performs this browser detection. But if you use a form-login and jump directly into AppSuite, the user will miss the warning where AppSuite statesthat an unsupported browser is used.
 
 
 
To show the same warning to a user without using the original AppSuite login page, you should include the browser detection lib in your own login page. That way you can show a warning to the user if they do not use a supported browser.
 
 
 
=== Including the browser.js lib ===
 
 
 
You can easily include the browser detection via script-tag in your own login page. It's a small, dependency free piece of Javascript code which adds a function to the global scope called <pre>isBrowserSupported()</pre>
 
 
 
The lib is located in the AppSuite UI under <tt>http://somedomain.com/appsuite/src/browser.js</tt>. Add this script tag to your page head <pre><script src="http://somedomain.com/appsuite/src/browser.js" type="text/javascript" charset="UTF-8"></script></pre>
 
 
 
In your page <tt>onLoad</tt> you can then call the global function <tt>isBrowserSupported</tt> which returns a boolean. If <tt>false</tt> is returned by the function you should show a warning to the user that his browser is not supported.
 
 
 
[[Category:Custom development]]
 
[[Category:Administrator]]
 
[[Category:Developer]]
 
 
 
[[Category:UI]]
 
 
 
[[Category:AppSuite]]
 

Latest revision as of 09:50, 22 May 2017

The content on this page has moved to https://documentation.open-xchange.com/latest/ui/how-to/browser-detection.html

Note: Open-Xchange is in the process of migrating all its technical documentation to a new and improved documentation system (documentation.open-xchange.com). Please note as the migration takes place more information will be available on the new system and less on this system. Thank you for your understanding during this period of transition.