BuycPanel Blog

BuycPanel Blog

Latest news and updates

How to Create Custom-Branded Login Pages

Posted by Allura on 01 01 2019.

Introduction
There are various ways of creating custom-branded login pages, namely:Duplicate the existing login theme
Modify the login page subheader logos
Modify other login page images
Modify other login page templates
Modify theme CSS files
Update your server’s locales
Use your new custom login themeDuplicate the Existing Login Theme
Steps:One can navigate to WHM’s Theme Manager interface (WHM >> Home >> Themes >> Theme Manager).Note that in cPanel & WHM version 11.48 and earlier, one has to navigate to WHM’s Universal Theme Manager interface (WHM >> Home >> Themes >> Universal Theme Manager).Then click on Manage Themes under Login.
One needs to click on Clone, available next to the theme that one wishes to duplicate.
Then in the available text box, enter a name for the duplicate theme and click on Submit.Thereafter, WHM will save the new theme in the /usr/local/cpanel/base/unprotected/themename/ directory, where themename will represent the name that…

Introduction

There are various ways of creating custom-branded login pages, namely:

  • Duplicate the existing login theme
  • Modify the login page subheader logos
  • Modify other login page images
  • Modify other login page templates
  • Modify theme CSS files
  • Update your server’s locales
  • Use your new custom login theme

Duplicate the Existing Login Theme

Steps:

  1. One can navigate to WHM’s Theme Manager interface (WHM >> Home >> Themes >> Theme Manager).

Note that in cPanel & WHM version 11.48 and earlier, one has to navigate to WHM’s Universal Theme Manager interface (WHM >> Home >> Themes >> Universal Theme Manager).

  1. Then click on Manage Themes under Login.
  2. One needs to click on Clone, available next to the theme that one wishes to duplicate.
  3. Then in the available text box, enter a name for the duplicate theme and click on Submit.

Thereafter, WHM will save the new theme in the /usr/local/cpanel/base/unprotected/themename/ directory, where themename will represent the name that one has entered.

Modify the Login Page Subheader Logos

One can replace any one or all of the subheader images in the /usr/local/cpanel/base/unprotected/themename/images/ directory.

For cPanel, WHM, and Webmail, the subheader images will appear at the top of the login pages.

It is important to make sure of the replacement images and its use in the correct dimensions to allow for the appropriate amount of padding within the login subheader containers.

Modify Other Login Page Images

One can replace any one or all of the other login theme images in the /usr/local/cpanel/base/unprotected/themename/images/ directory.

The images appearing in the default login theme are for the most recent version of cPanel & WHM. If an older version of cPanel & WHM is used, then make sure in checking the images in your default login theme and ensuring the use of correct image dimensions.

Modify the Login Page Templates

There is an option open to make the desired changes to your custom theme’s other login page templates. This include the main templates that are viewed by all users when they log in, error page templates, and templates for the Reset Password feature.

These template file controls what the users see when they log in, encounter login errors, or reset their passwords.

There is an option open to advanced users, where they can modify the main.tmpl  and resetpass.tmpl files to change how the system processes user input.

Some of the template files containing in the default cPanel and WHM login theme are listed below:

  • tmpl
  • tmpl
  • tmpl
  • tmpl
  • tmpl
  • tmpl
  • tmpl
  • html.tmpl
  • tmpl

Modify Theme CSS Files

One has the option to make desired changes to the style_v2.css and style_v2_optimized.css files.

Note that subheader logo customizations may necessarily need changes to the subheader logo style attributes. In that case, one has to modify these attributes under the login-sub-header div tag in the style_v2.css file.

Update your Server’s Locales

One must add new phrases to the server’s locales in case new text is added to the theme’s login templates.

For doing this, one has to use WHM’s Edit a Locale interface (WHM >> Home >> Locale >> Edit a Locale).

One can read our Guide to Locales  documentation to get more information on cPanel and WHM’s localization system.

Use your New Custom Login Theme

One has to select the theme’s name from the Default login theme menu in WHM’s Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings) to use new custom login theme.

Conclusion

All information about the ways of creating custom-branded login pages is outlined in this article.