ZCS Administrator Guide 8.0

Network Edition

Using Command Line Interface

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 reload