Secure Mobile Access 12.4 Administration Guide

Download PDF
Technical Documentation > Secure Mobile Access 12.4 Administration Guide > Components > User Access Components and Services > User Access Agents > WorkPlace > Customizing WorkPlace Templates

Customizing WorkPlace Templates

The appearance of WorkPlace is controlled using several templates. To customize the templates, you create an HTML file (or, in the case of a small form factor device, an xHTML or cHTML file) using any standard Web design tool or text editor.

If your customization includes graphics, upload them to this folder:

/usr/local/extranet/htdocs/__extraweb__/images

If an images directory is not already present, you can create it by typing the following command:

mkdir -p /usr/local/extranet/htdocs/__extraweb__/images

The file names you must use are described in How Template Files are Matched. For small form factor devices, a prefix is added:

  • For smartphone and PDA devices, prefix the file name with compact-.

  • For WAP devices, prefix the file name with micro-.

To customize the WorkPlace templates for desktop devices

  1. Create an HTML file containing the desired layout, and add the WorkPlace-specific tags:

    • Within the BODY tag, add an HTML COMMENT tag containing the word EXTRAWEB:

      <!-- EXTRAWEB -->

      This tag is required; it determines where to place content dynamically generated by the appliance. Without it, the user trying to log in to WorkPlace will be repeatedly sent back to the beginning of the authentication process.

    • Add a reference to the external JavaScript file:

      <script language="javascript"

      src="/__extraweb__/template.js"></script>

    • To have your templates display any WorkPlace content (including the .css file or the custom logo you configured in AMC), modify your HTML code to reference the /__extraweb__/images/ path. For example:

      <img src="/__extraweb__/images/mylogo.gif">

  2. Save the file with the appropriate file name using a .tmpl file extension.

To customize the WorkPlace templates for small form factor devices

  1. Create a file in xHTML (for smart phones or PDAs) or cHTML (for WAP devices) format containing the desired layout, and add the WorkPlace-specific tags:

    • Within the BODY tag, add a COMMENT tag containing the word EXTRAWEB:

      <!-- EXTRAWEB -->

      This tag is required: it determines where to place content dynamically generated by the appliance. Without it, the user trying to log in to WorkPlace will be repeatedly sent back to the beginning of the authentication process.

    • To have your templates display any WorkPlace content (including the .css file or the custom logo you configured in AMC), modify your code to reference the /__extraweb__/images/ path. For example:

      <img src="/__extraweb__/images/mylogo.gif">

  2. Save the file with the appropriate file name using a .tmpl file extension.

Was This Article Helpful?

Help us to improve our support portal

Yes! Not Really

Techdocs Article Helpful form

  • Hidden
  • Hidden

Techdocs Article NOT Helpful form

  • Still can't find what you're looking for? Try our knowledge base or ask our community for more help.
  • Hidden
  • Hidden