You can brand your users' cPanel interfaces with your custom logos and images to convey your company's brand message. The system stores your changes to the cPanel default themes as styles. A style has a distinctive appearance, but retains the same functionality as the default cPanel interface.
A cPanel plugin is a custom application that you can link directly from your users' cPanel interfaces. Plugins are style- and theme-independent. As a result, your plugin is available whether you use a cPanel-provided theme or a third-party theme.
To create a plugin for x3, use WHM's x3 Plugin File Generator interface (Home >> Development >> x3 Plugin File Generator).
After you generate the installation file, follow the steps in our Guide to cPanel Plugins documentation.
In cPanel & WHM software, the theme is the larger, skeletal framework to which the system applies the style.
We recommend that you use the x theme for WHM, the x3 or paper_lantern themes for cPanel, and the x3mail theme for Webmail.
The style, also known as a skin, contains the graphics that determine the appearance of a user's cPanel interface. Web hosts may also allow resellers to create or use their own styles to reflect their company's brands.
Styles are theme-specific. For example, if you create a style for the x3 theme or paper_lantern theme, it will not work on a third-party theme.
The location of each style file uses the following format:
In this example:
To customize a Paper Lantern style, follow the directions in ourdocumentation.
Brandingmodule to use includes for images and text
You can use cPanel API 2 cPanel API 2's Branding module functions or UAPI's Branding module functions to allow components of the graphical interface to indirectly interact with the cPanel source code. These API functions reference files in a particular style's path, and then include the appropriate HTML content in the page.
When you place these files in the style's directory and call them with cPanel Template Toolkit tags (
<cptt Branding>), cPanel caches these files into arbitrary textured images, or sprites. This significantly improves performance.
Some hosting providers, such as those who offer inexpensive hosting with limited features, prefer to charge their users for certain functions. For other web hosts, the technical limitations of their unique setups require them to remove certain functions to prevent user confusion.
To remove features, use WHM's Feature Manager interface (Home >> Packages >> Feature Manager).
The cPanel webmail interface inherits the CSS of the user's cPanel account.
To disable a particular webmail application for your users, add the following code to the appropriate style's Edit style-sheet page:
|Webmail client||Code to add|
You can edit the interface that your customers see when they log in to cPanel, WHM, or Webmail. These interfaces are the login themes.
The following files contain the default login themes:
|Service||Default login theme file|
To create your own theme, perform the following steps:
Run the following command to clone the default login theme and create the new
cp -pR /usr/local/cpanel/base/unprotected/cpanel /usr/local/cpanel/base/unprotected/mycpanel
Edit the themes to customize.
style.cssfile in your login theme's directory.
To display your custom login theme, select a value for the Default login theme setting in the Display section of WHM's Tweak Settings interface (Home >> Server Configuration >> Tweak Settings). This value defaults to cpanel.
To deploy a custom login theme across multiple cPanel & WHM servers, copy the files to each of your servers. Then, set each server's login theme in WHM's Tweak Settings interface.
The header and footer files reside in your custom theme's directory. These files wrap code around the login message, and provide the overall theme of the Login interface.
The header file provides all of the code before the login message, while the footer file provides all of the code after the login message.
The following table lists the location of the files for each service:
|Service||Header file location||Footer file location|