Knowledgebase

Overview:

This set of features allows you to manage themes for the Login and WHM interfaces. The system uses the cPanel & WHM theme as the skeletal frame on which to place the style or skin. The theme contains many elements, such as HTML and CSS.

To manage themes for the cPanel and Webmail interfaces, use WHM’s Customization interface (WHM >> Home >> cPanel >> Customization).

File dependencies

When you create your own themes or use a theme that cPanel, L.L.C. does not provide, you must ensure that the following files exist:

• /usr/local/cpanel/base/frontend/$theme/passwd/changepass.html

• /usr/local/cpanel/base/frontend/$theme/passwd/index.html

These files control interfaces that the system uses whenever you change a cPanel user’s password. If you do not copy or create these interfaces, users cannot change their passwords if the following conditions are true:

• You used WHM’s Force Password Change interface (WHM >> Home >> Account Functions >> Force Password Change) to require the user to change the account’s password.

• The user’s password is too old or too weak, as you defined in WHM’s Configure Security Policies interface (WHM >> Home >> Security Center >> Configure Security Policies).

Theme Manager

The Theme Manager interface allows you to manage the following themes:

• Paper Lantern — The theme that appears in the cPanel interface for cPanel users who use the Basic (Paper Lantern) theme. When you click Manage Theme for this theme, the system directs you to WHM’s Customization interface (WHM >> Home >> cPanel >> Customization). For more information about cPanel interface customization, read our Guide to cPanel Interface Customization - cPanel Style Development documentation.

• cPanel — The theme that appears in the cPanel interface for cPanel users who do not use the Basic (Paper Lantern) theme.

  Note:

  This interface no longer supports customization of this theme. Use WHM’s Customization interface (WHM >> Home >> cPanel >> Customization) to apply changes to this interface.

   

• Login — The theme that appears on the cPanel login interface.

• Webmail — The theme for webmail clients that ship with cPanel & WHM.

  Note:

  This interface no longer supports customization of this theme. Use WHM’s Customization interface (WHM >> Home >> cPanel >> Customization) to apply changes to this interface.

   

• WHM — The theme that appears in the WHM interface. You and your WHM users will see this theme.

Manage Themes

To manage a theme, click Manage Themes. After you select a theme to manage, you can view, download, clone, upload, and delete the theme.

Preview a theme

To preview a theme, click the view icon () that corresponds to the theme that you wish to view.

Clone a theme

When you clone a theme, the system creates a copy of the theme. To clone a theme, perform the following steps:

1. Click the clone icon () that corresponds to the theme that you wish to edit. A new interface will appear.

2. Enter a name for the cloned theme in the text box.

3. Click Submit. The system will clone the theme and display it in the Themes table.

Download a theme

To download a theme, click the Download icon (). The system will open a download prompt window. Click Save to save the theme.

Delete a theme

To delete a theme, perform the following steps:

1. Click the Delete icon (). The system will direct you to a confirmation interface.

2. Click Yes to confirm that you wish to delete the theme.

To cancel your changes, click No. The system will return you to the Theme Manager interface.

Upload and install a theme

To upload or install new themes, perform the following steps:

1. Click Manage Themes for the desired interface.

2. Under the Install Theme heading, click Choose File. Select the new theme’s file.

3. Click Upload. The new theme will appear in the Themes table.

Activate a theme (for WHM themes only)

Click the Activate icon () in the WHM Themes list. The WHM interface will change to the selected theme.

Addon Themes