Documentation

Unblu 6 (latest)

Unblu allows you to customize the Unblu product UI to fit your company’s corporate design by setting different configuration parameters that will be explained below.

If you want to customize your fonts see Using Custom Webfonts.

Brand Resources

General

Type: Url (To reference a local file use the file://` prefix. You can add authentication credentials like so: https://username:password@your.domain/path/to/zip/brand.zip)

Description: With the brand resources you may add your own logos etc., instead of the default Unblu logos.

The Url must point to a non-encrypted zip file containing the following files: favicon.ico, logo.png, logo_icon.png, logo_inverse.png, in the root of the archive.

If one of the images is missing or does not fit the specifications the Unblu default will be used as fallback.

Make sure the temporary directory configured in your servlet container points to a folder that is accessible by the application since the unzipped files are stored there. (Java environment variable: java.io.tmpdir)

Check the server startup log if one of the files does not behave as expected.

See the next sections for details and constraints on the different files.

Favicon

file name: "favicon"

file extension: ".ico"

max size: 100kb

description: This file will be used as favicon in the browser. (Typically displayed on the pages tab and in the bookmarks.)

default: favicon

example: favicon

file name: "logo"

file extension: ".png"

max size: 500kb

min width: 50px

max width: 300px

min height: 50px

max height: 144px

description: The logo image is displayed on the login, the loading, and the error the page.

default: logo

example: logo bank

Logo Icon

file name: "logo_icon"

file extension: ".png"

max size: 100kb

min width: 46px

max width: 96px

min height: 46px

max height: 46px

description: If activated, the logo icon is displayed on the right side of the agent tab bar (top bar on the agent desk). It may be activated with the configuration key: com.unblu.core.client.desk.showLogo=true (false by default). Also used for WebNotifications (notifications displayed by the browser).

default: logo icon

example: logo icon bank

Logo Inverse

file name: "logo_inverse"

file extension: ".png"

max size: 500kb

min width: 50px

max width: 300px

min height: 50px

max height: 144px

description: The Logo Inverse is displayed at the top of the navigation menu and any other location where it is placed on a dark background (usually the brand background color).

default: logo inverse

example: logo inverse bank

Concierge Avatar

file name: "concierge-avatar"

file extension: ".png"

max size: 500kb

min width: 48px

max width: 500px

min height: 48px

max height: 500px

description: The avatar used for the concierge.

default: concierge avatar

example: concierge avatar bank