Customizing Lockdown Menu Templates

You can build your own menu templates for Lockdown mode. 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 and customize it.

  1. While editing the Lockdown or Kiosk Mode profile configuration, select the Templates button to open the Edit Menu Template List dialog box.
  2. Select an existing menu template and then select the Copy button.
  3. With the new template selected, select the Edit button to open the Lockdown Menu Template Editor. You can edit the template directly in the Lockdown Menu Template Editor dialog box or copy the HTML document into your favorite text editor to edit and then paste it back into the Lockdown Menu Template Editor when you are finished.
  4. Customize the menu template to your satisfaction. Follow the guidelines below for best results.
  5. When you are satisfied with your changes, save your new template by selecting the OK button in the Lockdown Menu Template Editor dialog box.

Select the Rename button to enter a new name for your menu template in the New File Name field.

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.