Customizing Lockdown Menu Templates

SOTI MobiControl allows you to modify preconfigured lockdown menu templates or to build your own lockdown menu templates. A lockdown menu template is an HTML file with special menu tags that get replaced by SOTI MobiControl when it generates the menu. Essentially, the menu tags get replaced by the menu item links that you configure for your lockdown menu.

The easiest way to create a custom lockdown menu template is to make a copy of one of the default templates, customize it, and then add it to the list of available templates.

The following table describes the special menu tags that get replaced in the HTML file.

Tag Name Description
<MCMenuFull> This tag gets replaced with the full menu list that the user has configured. The menu items are separated by carriage returns.

Sample Menu Entries:

SOTI MobiControl Device Agent (launch://com.google.apps.maps)

My Website (http://www.mywebsite.com)

Template Resultant Menu

<html>
<body>
<MCMenuFull>
</body>
</html>

<html>
<body>
<a href="launch://com.google.apps.maps">SOTI MobiControl Device Agent</a><br/>
<a href="http://www.MyWebsite.com">My Website</a><br/>
</body>
</html>

<MCMenuN>

where "N" is the menu item number

This tag allows you to place each complete menu item where you want it in the HTML.

Sample Menu Entries:

SOTI MobiControl Device Agent (launch://com.google.apps.maps)

My Website (http://www.mywebsite.com)

Template Resultant Menu

<html>
<body>
1. <MCMenu0><br/>
2. <MCMenu1><br/>
</body>
</html>

<html>
<body>
1. <a href="launch://com.google.apps.maps">SOTI MobiControl Device Agent</a><br/>
2. <a href="http://www.MyWebsite.com">My Website</a><br/>
</body>
</html>

<MCLinkN> and <MCDispN>

where "N" is the menu item number

These tags let you further separate the menu item to be inserted into the "link" and the "display" text and control where in the HTML template they will be inserted.

Sample Menu Entries:

Android Calendar (launch://com.android.calendar)

Browse mywesbite (browse://www.mywebsite.com)

Report.pdf (file://mnt/sdcard/report.pdf)

Template Resultant Menu

<html>
<body>
1. <a href="<MCLink0>">
<font size=2><MCDisp0></font></a><br/>
2. <a href="<MCLink1>">
<font size=2><MCDisp1></font></a><br/>
3. <a href="<MCLink2>">
<font size=2><MCDisp2></font></a><br/>
</body>
</html>

<html>
<body>
1. <a href="launch://com.android.calendar">
<font size=2>Calendar </font></a><br/>
2. <a href="browse://www.mywebsite.com">
<font size=2>Browse mywebsite</font></a><br/>
3. <a href="file://mnt/sdcard/report.pdf">
<font size=2>Report.pdf</font></a><br/>
</body>
</html>

<MCExeIconN>

where "N" is the menu item number

This tag lets you display the built-in icon for an application executable that is in the program menu.

Sample Menu Entries:

Android Calendar (launch://com.android.calendar)

Browse mywesbite (browse://www.mywebsite.com)

Report.pdf (file://mnt/sdcard/report.pdf)

Template Resultant Menu

<html>
<body>
1. <a href="<MCLink0>">
<img src="<MCExeIcon0>"></a><br/>
2. <a href="<MCLink1>">
<img src="<MCExeIcon1>"></a><br/>
3. <a href="<MCLink2>">
<img src="<MCExeIcon2>"></a><br/>
</body>
</html>

<html>
<body>
1. <a href="launch://com.android.calendar">
<img src="SDCard/Lockdownimage/MCLD_Calendar.bmp"></a><br/>
2. <a href="browse://www.mywebsite.com>
<img src=" SDCard/Lockdownimage/MCLDBrowse.bmp"></a><br/>
3. <a href="file://mnt/sdcard/report.pdf">
<img src=" SDCard/Lockdownimage/MCLD_report.bmp"></a><br/>
</body>
</html>

<MCDispImgN>

where "N" is the menu item number

This tag lets you associate a picture with an entry in the lockdown screen.

Sample Menu Entries:

SOTI MobiControl Device Agent (launch://com.google.apps.maps)

My Website (http://www.mywebsite.com)

Template Resultant Menu

<html>
<body>
1. <a href="<MCLink0>">
<img src ="<MCDispImg0>">
</a><br/>
2. <a href="<MCLink1>">
<img src="<MCDispImg1>">
</a><br/>
</body>
</html>

<html>
<body>
1. <a href="launch://com.google.apps.maps">
<img src="/SDCard/Lockdownimage/Logo.png">
</a><br/>
2. <a href="http://www.MyWebsite.com">
<img src="SDCard/Lockdownimage/website.jpg">
</a><br/>
</body>
</html>

Including Pictures in Menu Templates

You can insert images into your template by simply using the Insert Image feature in the built-in HTML Template Editor. SOTI MobiControl will deliver the image to the device. Alternatively, if you do not want to use SOTI MobiControl to deliver the image, you can simply specify in the HTML template the full path to the graphic for where it will be found on the mobile device (e.g. <img src="file:///SDCard/images/CompanyLogo.jpg">).

URIs

Uniform Resource Identifier (URI) is a string of characters used to identify a name or a resource on the Android Device. Such identification enables interaction with representations of the resource using specific protocols. Schemes specifying a concrete syntax and associated protocols define each URI. The SOTI MobiControl Lockdown on Android devices allows you to use custom URIs. Such URIs include Launch://, Http://, Https://, File:// and Browser://.

Linking to the SOTI MobiControl Device Configuration Applet

The SOTI MobiControl device applet that is normally accessed by tapping on the SOTI MobiControl icon on the Today screen or system tray of the device contains a bounty of useful status information. This information can be very useful when trying to troubleshoot a problem in the field, for example resolving connectivity issues between the device and the SOTI MobiControl deployment server.

To create a link to the applet from the lockdown program menu add a program entry to the following path: net.soti.mobicontrol

Edit Menu Template List

In the Edit Template Menu List dialog box, click Add and navigate to the location of your customized lockdown page and select it. You will see the customized menu template in this list now. You can chose to edit this template further by clicking on Edit and launching the lockdown menu template editor, or click on Close and then select the template from the Lockdown Menu.

You can edit the lockdown menu templates using the built-in HTML editor. After saving a modified template, be sure to select the template file in the combo selection box on the main Lockdown Configuration page. Basic HTML, Java, and Flash are supported in the lockdown.

Tip: You can easily include a graphic in your HTML template by selecting the Insert Image menu option in the HTML Editor.