Customizing the application launchpad

Opening the template editor

To customize the launchpad, you edit a collection of files and templates named Single Sign On Schema. To open the collection in a template editor, navigate to the Single Sign On default settings and select Single Sign On Schema from the Collection drop-down list.

Files in the /dat folder vs. /files folder

When generating the launchpad, the Single Sign On module uses files located in the following folders on the server where the appliance is installed and the SSO process is running:

• /dat — Files in this folder are system files maintained by the appliance. They are overwritten each time there is an update from the update server.
• /files — Files in this folder and subfolders, including /img, can be customized, because they are not overwritten by the update server.

Edit the Launchpad.html file

In the Launchpad.html file, you can specify a name and description for your organization and the names of the style sheet and the image files containing logos. You can also customize the header, footer, and sidebar that frame the launchpad.

For example, you can add a message of the day or links to your IT organization to the sidebar.

1. Select Policy | Settings.
2. Expand Engines | Single Sign On, then select Default.
   The Single Sign On settings open.
3. From the Collection drop-down list, select Single Sign On Schema, then click Edit.
   The Template Editor opens with the Single Sign On Schema folder selected.
4. Expand Single Sign On Schema | Launchpad | en, then select html.
   The HTML Editor opens.
5. In the editor:
   1. Replace Your Company Name with the name of your organization.
   2. Replace Your Company Description with a description of your organization.
   3. (Optional) Replace customLaunchpad.css with the name of your custom .css file.
   4. Replace sample_logo.png with the name of the image file containing the logo that represents your organization.
   5. Replace productCompLogo.png with the name of the image file containing the logo that represents your product.
6. To customize the header, add content to the <div id="header"></div> element.

7. To customize the footer, add content to the <div id="footer"></div> element.

8. To customize the sidebar:

1. Add the <div id="aside"></div> element to the launchpad.html file, as follows.

<div id="main">
<div id="aside">
:
:
</div>
$SSO.GetDatFile(“launchpadMain.html”)$
</div>

2.  Add content to the <div id="aside"></div> element.
   Example:

<div id="aside">
<img src="/files/img/your_logo.png">
<hr>
$first line of SSO.GetDatFile(“version.txt”)$
<hr>
MWG: $MWG.Version$<br>$MWG.BuildNumber
</div>

This example displays the logo you provide, the version number of the latest update from the update server, and the version and build numbers of the appliance in the sidebar.

9. To close the Template Editor, click OK.
10. Click Save Changes.

Edit the default launchpad style sheet

In the default launchpad style sheet that comes with the appliance, you can customize the look of your organization's name and description. You can also customize the header, footer, and sidebar that frame the launchpad.

For example, you can specify the background image that frames the launchpad. The image file can be located in the /files/img or /dat folder.

1. Select Policy | Settings.
2. Expand Engines | Single Sign On, then select Default.
   The Single Sign On settings open.
3. From the Collection drop-down list, select Single Sign On Schema, then click Edit.
   The Template Editor opens with the Single Sign On Schema folder selected.
4. In the File System area, expand singleSignOn, then select customLaunchpad.css.
   The Editor opens.
5. In the editor, specify the font color, font-size, and font-family properties of your organization's name and description as you want them to look on the launchpad.
   Example:

/* Organization Name */
#mainDesc
{
color:RGB(51,51,51);
font-size: 12pt;
font-family:verdana;
}
/* Organization Description */
#subDesc
{
color:RGB(102,102,102);
font-size: 9pt;
font-family:verdana;
}

6. In the editor, specify the background image that frames the launchpad.
   
   In the following example, the background image can be a logo that is repeated until it fills the frame around the launchpad. 

body {
width: 100%;
}
#main {
// In one of the following lines, replace <image_file> with the filename
// of the background image and remove the comment tag from that line:
// background: url("/files/img/<image_file>") repeat;
// background: url("/dat/<image_file>") repeat;
padding: 0px;
}
#aside {
display: inline-block;
width: 100px;
align-self: flex-start;
}

7. To close the Template Editor, click OK.
8. Click Save Changes. 

Import a custom launchpad style sheet

In the user interface, you can import a launchpad style sheet. It can be one that you exported and edited or one of your own.

1. Select Policy | Settings.
2. Expand Engines | Single Sign On, then select Default.
   The Single Sign On settings open.
3. From the Collection drop-down list, select Single Sign On Schema, then click Edit.
   The Template Editor opens with the Single Sign On Schema folder selected.
4. In the File System area, select singleSignOn.
5. From the Add drop-down list, select Existing File or Directory, browse for your style sheet file, then click Open.
   Your style sheet file is added to the File System under singleSignOn.
6. To close the Template Editor, click OK.
7. Click Save Changes.

Provide a custom logo for the launchpad

To provide a logo that represents your organization or product on the application launchpad, import a custom image file.

1. Select Policy | Settings.
2. Expand Engines | Single Sign On, then select Default.
   The Single Sign On settings open.
3. From the Collection drop-down list, select Single Sign On Schema, then click Edit.
   The Template Editor opens with the Single Sign On Schema folder selected.
4. In the File System area, expand singleSignOn, then select img.
5. From the Add drop-down list, select Existing File or Directory, browse for the file containing your logo, then click Open.
   The image file is added to the File System under img.
6. To close the Template Editor, click OK.
7. Click Save Changes.