The instructions in this section are intended for users who wish to modify the 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.

Note: In order to change the entire look of the application, including any re-branding or style changes as part of a broader process of customization, refer to the Customizing Page Layouts for ATG Knowledge section. The style sheets and images used in the application can be customized using the same processes and procedures described in that chapter.

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

  1. Copy the application style sheet and image directories to the location where you would like them to reside. These directories can be found in <ATG2007.3dir>/Service2007.3/Service/Agent/reference/. The location to which they are copied should be Web accessible. This could be in the directory <ATG2007.3dir>/home/doc/ or any other suitable location.

  2. Create a file at <ATG2007.3dir>/localconfig/atg/svc/agent/ui/
    AgentUIConfiguration.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.

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

    frameworkStylesheet=<replacement of framework.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 Knowledge 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 application style sheet into this directory and customize it as desired. To reference this theme rather than the default theme, add this line to AgentUIConfiguration.properties:

    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) to browse to this nucleus component. Note: Do this with extreme caution on production systems.

 
loading table of contents...