Administration Guide

Customizing the appearance of SSP pages

On-prem only

The style definitions for SSP are controlled by config.less files written in Less — a dynamic style sheet language that can be compiled into cascading style sheets (CSS). For more information on Less, see http://lesscss.org/.

FOR CLOUD CUSTOMERS: Please note that homepage customization is only available for on-premises deployments. Contact our Support Team for assistance with this step.

Each theme for the Self Service Portal includes its own config.less file. You'll find these files located in the respective theme folders inside the HomePage folder:

[PhysicalPathToSSP]\HomePage\[theme name]

To customize the appearance of your SSP pages, you need to edit the config.less file where colors are defined as variables, for example:

/* Main theme color */
				@base-color: #f5f5f5;    // Default theme 8
				//@base-color: #d6d6d6;  // Default theme 7
				//@base-color: #b0b0b0;  // LightGray
				//@base-color: #126180;  // Navi  

				@light-color: @base-color; 
				//@light-color: lighten(@base-color, 15%);
				@dark-color: desaturate(darken(@base-color, 45%), 20%);
				@darker-color: desaturate(darken(@base-color, 12%), 10%);

				/* Page header */
				@header-background-color: @base-color;
				@header-background-color2: @header-background-color;
				// Other header styles...
		

The variables listed above control the base color, its light and dark variants, and the color of the page header.

When you change the base-color value, the colors of HTML elements controlled by the color theme (defined as derivatives of the base color) are updated correspondingly. The colors of the elements that are not controlled by the color theme (for example, buttons) can be customized separately.

Here is an example of how you can customize the color of the OK button. The button color variables are defined in config.less as follows:

/* Buttons */
				@button-primary-color: #f6d996;
				@button-primary-caption-color: @button-secondary-caption-color;
				@button-secondary-color: #e9ebee;
				@button-secondary-caption-color: #0;
				@button-cancel-color: #e9ebee;
				@button-cancel-caption-color: @button-secondary-caption-color;
		

Where the button-primary-color is the color of the OK button and button-primary-caption-color is the color of its caption.

Similarly, you can customize styles for other HTML elements. For example, use the @base-font variable to customize fonts.

Each theme folder also includes a SearchBackground.jpg file. This file is used to set the background for the search pane in that theme.

NOTE: Any changes in config.less file are applied immediately when you refresh the page in your web browser. You do not need to restart the IIS server and/or the Self Service Portal. You can easily revert to the original configuration by replacing your customized config.less file with the config.less.default file from the SSP template. Each theme for the Self Service Portal includes its own template. You'll find these templates located in the respective theme folders at \\System\WebAppsTemplates\SSP\HomePage\[theme name] under your Alloy Navigator installation folder.