Difference between revisions of "AppSuite:Browserdetection"

(Including the browser.js lib)
(Including the browser.js lib)
Line 10: Line 10:
 
=== Including the browser.js lib ===
 
=== 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>
+
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>
 
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.
+
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:Custom development]]

Revision as of 14:54, 9 January 2014

Browser detection outside AppSuite

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

isBrowserSupported()

The lib is located in the AppSuite UI under http://somedomain.com/appsuite/src/browser.js. Add this script tag to your page head

<script src="http://somedomain.com/appsuite/src/browser.js" type="text/javascript" charset="UTF-8"></script>

In your page onLoad you can then call the global function isBrowserSupported which returns a boolean. If false is returned by the function you should show a warning to the user that his browser is not supported.