Application Packaging Standard

Last updated 18-Mar-2019

Demo Project

The following basic demo procedures will help you be more confident in skin customization.

Set Local Development Environment

  1. Download and install Koala or LESS CLI on your computer.

    Skip this step if you have one of the compilers installed on your computer.

  2. Download the skin source bootstrap.zip file from the management node. The path to the file depends on the WildFly version, as in the following command:

    $ scp root@a.isv1.apsdemo.org/usr/local/pem/wildfly-10.1.0.Final/ext/aps/2/ui/runtime/theme/bootstrap.zip
    

    Unzip the archive. You will find all source files in the ./bootstrap/ folder.

  3. If you use Koala, drag and drop the new bootstrap/ folder into the Koala workspace.

    Optionally, for the sake of simplicity, you can remove all files from the Koala workspace, except for bootstrap.less and the skins/variables.less files you are going to customize. This will not delete any files physically from the bootstrap/ folder.

  4. In Koala, verify if the output file for bootstrap.less is bootstrap.css.

    ../../../../_images/koala-config.png

When using LESS CLI there is do not need to do any preparations.

Apply Predefined Skin

As a first step, try to apply a predefined skin from the source package to test the customization procedure as explained here.

  1. Copy the content of a sample skin file, for example, skins/skin-yellow.less, to the skins/variables.less file.

  2. Depending on the LESS compiler you use, compile the package as follows.

    In Koala, right click on bootstrap.less and select Compile. In a case of errors, you will see a pop-up screen with an error message. Fix the errors and compile the project again. On success, you will have the output bootstrap.css file.

    If you use the LESS CLI:

    • Enter inside the top level folder:

      $ cd bootstrap
      
    • Compile the skin into the bootstrap.css file:

      $ lessc bootstrap.less bootstrap.css
      
  3. On your management node, navigate to
    /usr/local/pem/wildfly-10.1.0.Final/ext/webgate/static/skins/v3/ccp2/ and save the original bootstrap.css file under another name.

    Note

    The internal version 10.1.0 is valid at the moment of writing this section and can be changed later.

  4. Copy the compiled bootstrap.css file to the management node. For example, if your management node is a.isv1.apsdemo.org, use this command:

    $ scp bootstrap.css root@a.isv1.apsdemo.org:/usr/local/pem/wildfly-10.1.0.Final/ext/webgate/static/skins/v3/ccp2/
    
  5. Use your browser to log in UX1. You will notice the changed view of the customer panel.

    ../../../../_images/skin-yellow.png

Customize Skin

Make your own customization in the skin as follows.

  1. In the skins/variables.less file, modify some elements. For example, to make the page background darker, modify the following element:

    @brand-color-0:   #777777; // #ffffff - original value - Page background
    
  2. Compile the project and copy the bootstrap.css file to the management node.

  3. Refresh UX1 in your browser. The browser cache can prevent the contents refresh. In this case, turn on the browser development tools and then refresh the browser.

    ../../../../_images/skin-test.png

Pay attention to the changed background color.