Customize a Theme

capm supports user interface themes. These themes primarily describe the colors that are used to draw the user interface and when generating PDF files.  Several themes are shipped with the product (CA-Blue, CA-Gray, CA-White). You can define more site-specific themes, which provide different color schemes.
capm360
HID_Customize_a_Theme
CA Performance Management
 supports user interface themes. These themes primarily describe the colors that are used to draw the user interface and when generating PDF files.  Several themes are shipped with the product (CA-Blue, CA-Gray, CA-White). You can define more site-specific themes, which provide different color schemes.
Custom themes require reconfiguration every time a new version of
CA Performance Management
is installed. Carefully consider whether a new theme is necessary. Only experienced administrators should customize themes.
If you only want to apply a unique logo, simply manage your theme settings and apply a new logo.
Create a New Theme
The theme directories that are shipped with the product are CA-Blue, CA-Gray, and CA-White. To define more site-specific themes, duplicate one of the existing theme directories using an appropriate naming convention. Then deploy the theme in
Performance Center
.
Define the custom theme directory name as "XXXXXXX-Theme" where XXXXXXX is some identifier that the user can define. For example, "CA-Blue-Modified-Theme". The name should exclude any spaces or special characters.
If the theme directory name is appended with "-Theme," it is available for deployment and it is preserved during an upgrade. Custom theme directories are not preserved after an uninstall. Custom themes require reconfiguration every time a new version of
CA Performance Management
is installed.
You can use the following procedure to change the user interface coloring, icon coloring, or the PDF font and coloring.
Follow these steps:
  1. Go to the following location:
    /
    PC
    InstallDirectory
    /PerformanceCenter/PC/webapps/pc/css
  2. Package one of the existing standard theme directories. For example, zip up the CA-Blue theme.
  3. Copy the ZIP file to your local computer, unzip it, and name it appropriately.
    Define the custom theme directory name as "XXXXXXX-Theme" where XXXXXXX is some identifier that the user can define. For example, "CA-Blue-Modified-Theme". The name should exclude any spaces or special characters.
  4. Do any of the following tasks:
    • To change the user interface coloring, go to the 
      /
      ThemeDirectory
      /includes
       directory and edit the
       capc_theme.css
       file. When you are done editing 
      capc_theme.css
      , copy and replace 
      capc_theme.css
       to 
      capc_theme-min.css
      .
      Example:
      To change the background color, locate the comment "page background color" and replace the color #f7f7f7 with "pink".  After you save the file, users using your theme have a pink page background color instead of a pale gray one.
    • To change the icon coloring, go to the 
      /
      ThemeDirectory
      /images
       directory and edit the relevant files in a graphics editor.
      Example:
      To change all the gray icons to be white icons, edit the 
      IconsSecondary.png
       file.
    • To change the PDF font and font coloring, go to the 
      /
      ThemeDirectory
      /xsl/pdf
       directory and edit the 
      defaultPageContent.xml
       file.
  5. Package the customized theme directory and name it appropriately.
  6. From the 
    Performance Center
     UI, manage your theme settings, and deploy the new theme.
Manage Your Theme Settings
To change the logo that appears in PDF report headers or apply a different existing theme, edit your theme settings. By default, all themes use the CA Technologies corporate logo. As a global administrator, you apply a theme to a specific tenant. If you do not deploy multi-tenancy, the theme applies to the default tenant. For more information, see Manage Tenants.
You can upload and apply a unique logo to the PDF output.
Follow these steps:
  1. Log in as a user with the Administrator role.
  2. Hover over 
    Administration
    , and click
    Group Settings: Themes
    .
    The Theme Settings page opens.
  3. To upload a unique logo, click 
    Browse
     and select the image file for your logo.
  4. To apply the logo the logo to a theme, select the theme from the
    Apply to theme
    drop-down list.
    If you do not deploy multi-tenancy, select 
    All Themes
    .
  5. Click 
    Upload Image
    .
  6. Edit the tenant to select the theme that you modified.
    To restore the default theme settings, click
    Reset Images
    .
Deploy a Theme
After you create a theme, you must deploy the theme to use use it.
Follow these steps:
  1. Log in as a user with the Administrator role.
  2. Hover over 
    Administration
    , and click 
    Group Settings: Themes
    .
    The Theme Settings page opens.
  3. In the Deploy a Theme section, click
    Browse
    , and select the new theme.
    The maximum filesize is 100 MB. The file must have a ZIP file extension. One top-level theme directory should exist in the ZIP file. The name of the theme directory must end with "-Theme".
  4. To replace an existing theme, select
    Replace existing themes
    .
  5. Click
    Add
    .