Device Redirection Documentation

This page should give you a more robust information about the Device Redirection widget developed by XtWidgets. As of release, the widget was made by Shahmi. Any bugs or suggestions OR any enquiries you may contact him directly via XtBoard, XtGem Forum or by email, technosparks(at)outlook.my . Or if you have any troubles contacting him, try to contact him through XtWidgets team.

As of the introductory article, this widget aims to allow XtGem users to redirect their users in some occasions.


Origin of code

As promised, the Device Redirection widget was coded with the Mobile Detect script as it's backbone. It is open-source and handled at GitHub.

http://mobiledetect.net/ - Mobile Detect

If any updates were found on the GitHub repo, we will update it as soon as we can. As the source was open-source, widget will remain free forever.

Availability

The widget is hosted on the GreenWap server. If the server is down, the widget will be down too. If we can tell if there will be any server break-down, we will broadcast a warning on the forums. However, this does not include any instant breakdown for example excessive bandwith, requests, server error, cartridge failures, CPU or hard-drive failures etc on GreenWap server.


When to use

The widget is perfect to use in the <head> section of your source code. Creating this widget in your _header file would be ideal, though you can still put such widget in a respective page. If the two widgets were put at the same page, the first one will be usable. This means, this widget is not meant for a simple redirection. Also, the client (users of your site) must have JavaScript enabled, since, server-side redirection is impossible.


Options available

This widget provide 3 options and 1 sub-options for each options.


Based on the device you wish, select "true" for a respective device. You can set "true" for multiple devices.

     • tablet-redir


Then, you should tell the widget about your append-type redirection.

subdomain
will make your redirection append a text at the start of URL for example http://a text.yoursite.xtgem.com

subdir
will make your redirection append a text at the end of the hostname for example http://yoursite.xtgem.com/a subdir

urlparse
will make your redirection append a text as a query at the end of URL for example http://yoursite.xtgem.com?something=1

none
will make your redirection to a URL you have set

If tablets is not ticked, it will be served as mobile


To use the <xt:widget> tag

You can use the HTML version of the widget. Below is the source of the widget as set by the building tool

<xt:widget id="device-redirection-widget" desktop-redir="false" mobile-redir="false" tablet-redir="false" append-type="subdomain" desktop-redirect-uri="web" mobile-redirect-uri="m" tablet-redirect-uri="tab" />

Thank you

Thank you for using widgets made by XtWidgets