Manage your webmail interface branding (OpenSRS control panel)

Branding is the process of changing the look and feel of the Webmail interface to visually represent your company. Branding may include adding proprietary logos, changing type face, adding company colors, and inserting ads or dynamic content.

There are three distinct phases in managing a brand:

1. Creating the brand.

2. Designing or customizing the brand.

3. Assigning the brand.

When you create a new brand, it is always based on the default brand. Once you create the brand, you can display and customize it to achieve your desired look.

Brands can be assigned company-wide and also per specific domain.  The process is very similar, so be sure you are in the correct spot in order to assign the brand to the correct item.

Creating a new brand in the Control Panel

To create a new brand

1. In the Email section of the Control Panel, on your company page, click the Brands tab.

2. Click the Add icon at the top of the page.

Creating a new brand in the control panel 

3. On the Add a Webmail Brand popup, enter a name for your brand, and then click Add.
The brand name is added to the list of available themes.

4. On the Brands page, click the brand name.
The Editing brand window appears.

Each item within the page allows customization of the brand.  Click Help within the editor for each section for details.

Setting the default brand for a company

To assign a brand to a company:

1. In the Email section of the Control Panel, on your company page, click the Settings tab.

2. In the Domain and User Inheritance section, click Edit.

3. Below the Brand heading, click to put a checkmark in the box beside Override inherited value.

4. From the drop-down box, choose the brand that you want to apply to this company.

5. Click Save.

The company brand will apply to all domains and users under the company; however, you can override the company’s default brand setting for particular domains or user.

Assigning a brand to a domain

To assign a brand to a domain:

1. In the Email section of the Control Panel, click the Email Domains tab and then click the domain to which you want to assign a brand.

2. Click the Settings tab.

3. In the User Inheritance section, click Edit.

4. Below the Brand heading, click to put a checkmark in the box beside Override inherited value.
This allows you to assign a brand other than the company brand.

5. From the drop-down box, choose the brand that you want to apply to this domain.

6. Click Save.

Modifying Brand Settings

There are a variety of settings in webmail that can be configured in the brand settings page. 

Brand SectionOptions
Basic SettingsHelp URL, brand lock, logout URL, etc.
Default for New UsersDefault Full-Pane Mode
Component SettingsEnable or disable webmail components like calendar, contacts, and file storage. 
FilesUpload image files for the header and footer
ColoursModify various colours used in the webmail interface.
Custom Login PageSet a custom login page which will display at mail.yourdomain.com
HeaderConfigure a custom header image
FooterConfigure a custom footer image
Sidebar AdSet an advertisement for your company.
 

Creating a custom webmail login page

To create a custom webmail login page:

1. In the Email section of the Control Panel, on your company page, click the Brands tab.

2. Click on the brand you wish to manage.

3. Under the Custom Login Page heading click Edit.

4. On the Display option click Enable.

5. You can use the following sample code to create your own custom login page. Simply replace logo.jpg with the name of the file you uploaded to your brand files:

<!--- Reseller Access - Custom Login Page --->

<style>
  body {url(images/linen.jpg) repeat #d1d5d8;}
</style>
<div id="login-form">
  <div id="login-logo">
    <img src="%%DIR%%/content/logo.jpg" id="logo">
    </img>
  </div>
  <div class="box-inner">
    %%LOGIN_FORM%%
  </div>
</div>

Was this article helpful? If not please submit a request here

How helpful was this article?