This procedure shows you how to change the variables related to the relog prompt for autologout. It involves setting theme variables.

Overview

The relog prompt allows a user to resume an application after an auto logout event.

The default relog prompt screen has a black background and white text, as in Figure 1.

Figure 1: Default relog prompt

You can edit the appearance of the relog prompt using the gbc-SessionLogPromptWidget-color and gbc-SessionLogPromptWidget-background-color theme variables.

Before you begin

This procedure assumes you are comfortable updating theme parts and themes. For the basic principles behind themes and theme parts, see How customization works. For instructions about adding and modifying themes and theme parts, see Manage themes.

Edit theme variables

1. Identify the theme part you plan to update. If you are creating a new theme part, prepare the directory.

2. In the theme part, open the theme.scss.json file in a text editor.

3. To add additional icons in the stylesheet, edit the gbc-SessionLogPromptWidget-color and gbc-SessionLogPromptWidget-background-color variables. For example:

   // in theme.scss.json
   {
   …
   "gbc-SessionLogPromptWidget-background-color": "Blue",
   "gbc-SessionLogPromptWidget-color": "Red",
   …
   }
   

4. If you created a new theme part, add it to one or more themes.

Compile

After updating theme.scss.json with the theme variable and ensuring the theme part is assigned to one or more themes, you compile your customization.

$ gbc build --customization customization-project-dir

Test

Test your changes work by logging in with the incorrect credentials and waiting for the relog prompt, as in Figure 2.

TIP: You may need to use CTRL + F5 to clear the browser cache before you see your changes.

If your tests do not behave as expected, ensure you are using your newly-compiled custom GBC. Depending on your development environment, you may need to package and deploy a custom GBC client. For information on which customization and theme you are using, see Selecting customizations and themes.