Re-branding ATG Self Service

The instructions in this section are intended for users who wish to modify the Self Service look without making any other customizations to the web application. These instructions are also applicable for remote hosting of images, which you might do for performance reasons.

There are two steps required in preparation to modify the look of the ATG Self Service application:

1.Copy the application style sheet and image directories to the location where you would like them to reside. These directories are in <ATG9dir>/Service9.4/Service/SelfService/reference/. The location to which you copy them should be Web accessible. This could be in the directory <ATG9dir>/home/doc/ or any other suitable location.

2.Create a file at <ATG9dir>/localconfig/atg/svc/self/ui/
SelfServiceUIConfiguration.properties containing the following lines:

imageLocation=<top-level image directory>


cssLocation=<css directory>

These directories do not have to be local. Note that the subdirectory structure under the image directory, including file names, must be preserved in order for the application to use any changed images without customization of the Web application itself.

If you need to rename the two style sheets used in the application, add the following lines to SelfServiceUIConfiguration.properties:

contentStylesheet=<replacement of styles.jsp>
outerStylesheet=<replacement of outerStyles.jsp>

You are now ready to make any desired changes to this style sheet and these images. The running application will reflect those changes.

ATG Self Service also supports the use of themes. To create a new theme, create a new subdirectory of the /css/ directory with the theme name as the directory name. Copy the two application style sheets into this directory and customize them as desired. To reference this theme rather than the default theme, add this line to the SelfServiceUIConfiguration.properties file:

theme=<theme name>

In this way, you can maintain multiple themes for the application in parallel. Use this mechanism to switch between the themes.

If you want to make these changes to a live configuration, you can edit these properties using the ATG Control Center (ACC) or using ATG Server Admin to browse to this nucleus component. Do this with extreme caution on production systems.