ZCS Administrator's Guide Network Edition 6.0.8

Using Command Line Interface to

Add Your Logos

Examples

Changing the ZWC theme base colors and logos is performed from the command line using the zmprov command.

Change Theme Colors

The color code is entered as a six-digit hexadecimal code.

Attributes

The following attributes are configured either as a global config setting or as a domain setting:

•	zimbraSkinBackgroundColor. Enter the hex color number for the primary background color displayed in the client.

•	zimbraSkinSecondaryColor. Enter the hex color number for the toolbar and selected tabs.

•	zimbraSkinSelectionColor. Enter the hex color number for the color of the selected item.

•	zimbraSkinForegroundColor. Enter the hex color number for the text. This usually does not need to be changed as the default is black.

How to change base colors for themes

Before you begin, identify the six-digit hexadecimal base color values for the various elements you are changing. The commands are entered as:

•	For Global: zmprov modifyConfig <attribute-name> [“#HEX_6digit_colorcode”]

•	For Domain: zmprov modifyDomain <domain> <attribute-name> [“#HEX_6digit_colorcode”]

To modify a domain

In this example, the following base colors are being changed:

•	Background color to Coral, #ff7F50

•	Secondary color to turquoise, #ADEAEA

•	Selection color to yellow, #FFFF00.

1.	As the Zimbra user, type the following

zmprov modifyDomain domainexample.com zimbraSkinBackgroundColor “#FF7F50” zimbraSkinSecondaryColor “#ADEAEA” zimbraSkinSelectionColor “#FFFF00”

The quote marks, “”, are required so the use of the # sign does not comment out the text that follows.

2.	To apply the changes, type

zmmailboxdctl

ZCS themes for that domain now display these colors.

Add Your Logos

Attributes

You add the company logo information and URL by modifying these attributes:

•	zimbraSkinLogoURL. Enter the company Web address that you want linked from the logo.

•	zimbraSkinLogoLoginBanner. Enter the company logo file name that is displayed on the login and splash screens for the ZWC and the ZCS administration console.

•	zimbraSkinLogoAppBanner. Enter the logo graphic file name for the graphic in the upper-left of the ZWC application and the administration console.

To add logos for a domain

1.	As the Zimbra user, type the following

zmprov modifyDomain domainexample.com zimbraSkinLogoURL http://example.com

zmprov modifyDomain domainexample.com zimbraSkinLogoLoginBanner http://imageserverexample.com/directory/logo_banner_name.png

zmprov modifyDomain domainexample.com zimbraSkinLogoAppBanner http://imageserverexample.com/directory/banner_app_logo.png

2.	To apply the changes, type

zmmailboxdctl

Examples

Figure 4: Web Client before changing the base colors

Figure 5: Web Client Login Page after changing base colors

The base color and variations of the base color are displayed.

The Company logo displayed here and on the splash screen is 450 x 100.

Figure 6: Web Client after changing the base colors

ZCS Administrator's Guide Network Edition 6.0.8