Skip to main content

Layout customization using skinning

The visual appearance of the Web Client can be customized using skinning. The required CSS files, images, and libraries can be saved on the file system.

Please proceed as follows to create a customized skin:

  1. Create a folder called design in the ConSol CM data directory (value of the system property cmas-core-shared, data.directory), see Data directory.
  2. Create a folder within the design directory and set the system property cmweb-server-adapter, themeOverlay to the name of this folder.
  3. Add the customized layout files. There are two possibilities:
    • You can place everything in the theme folder. The theme folder can contain one or several files with the custom styling.
    • You can create a file called theme_<folder name>.css. Its content is merged with the default CSS file.
  4. The changes are loaded automatically.
info

If you do not want to set the system property, you can create a subfolder called default and use it for your skin files.

The existing default styling is only overwritten for the aspects which are explicitly configured in the custom skin. It is therefore possible to create, for example, a custom CSS file which only contains the settings which should be changed with respect to the default styling. This facilitates the maintenance of the custom CSS file after ConSol CM updates.