Creating and Using Custom Skins

You have the option to change the default appearance of the Stardust Portal by creating custom skins, which you can select in the Portal Configuration view.

This chapter covers the following:

Creating Custom Skins

To create a custom skin:

  1. Switch to the Resource Management View of the Administration Perspective.
  2. Create a skin folder under the provided skins folder. The name of the custom skin will be the name of the created folder accordingly.

  3. A skin consists of one or more style sheet css files. Create the according style sheet(s) and upload to the custom skin folder. Refer to section Example Style Sheet for an example how such a style sheet could look like.

  4. Also upload files needed for the style sheet, e.g. create an images folder, where you upload the required image files too.

Now you can see your custom skin in the Skin section of your Portal Configuration view.


Figure: Select your custom skin.

Example Style Sheet

The following sections shows example style sheet classes for a custom skin overriding the default appearance.

Hiding the Copyright from footer

.sg-footer-bar .sg-copyright {
        visibility: hidden;
}

Hiding the build information from footer

.sg-build-info {
        display: none;
}

Hiding Alerts from header

.sg-alerts {
        display: none;
}

Hiding the logged-in user from header

.sg-sign-out {
        display: none;
}

.sg-common-menu {
    background-image: url("./images/banner.jpg");
}

To hide the logo

.sg-common-menu {
        display: none;
}

Importing a Skin provided as Plugin Jar

In case you like to import a skin that is defined via a plugin jar, you have to add this jar file to the lib folder of your runtime environment. The defined skin then is available and can be selected in the Portal Configuration view. Section Creating a Portal Skin to be provided as Plugin Jar of chapter Using the Portal Framework in the Online Documentation - Programming Guide Creating a Portal Skin to be provided as Plugin Jar of chapter Extending the Stardust Portal Components in the Programming Guide describes the structure that is required for the usage of such a plugin.