Difference between revisions of "AppSuite:Browserdetection"

(Including the browser.js lib)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Browser detection outside AppSuite ==
+
The content on this page has moved to https://documentation.open-xchange.com/latest/ui/how-to/browser-detection.html
[[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.
+
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.
 
 
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 to your own login page. It's small, dependency free peace of Javascript code which adds a function to the global scope called <pre>isBrowserSuppported()</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 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.