Do It the Paper Lantern Style

Posted by Jamison on 17 12 2015.

Finally, all your preparations and planning for a custom Paper Lantern style have paid off: you are now ready to roll it out to your customers. So how do you go about it? Here’s what you need to know.

Pre-setup

Before you begin the deployment, you first need to upload the custom style you developed to a certain folder you would name based on your preference.

Let us say that the name of your company is ABC Hosting. The custom style you created is called ABC_Hosting. The style needs to be uploaded to a folder you should name “ABC_Hosting” in/var/cpanel/customizations/styled.

Step 1. Set the default style for all your users.

To set the default style, follow this procedure:

ssh root@server.example.net

cd /var/cpanel/customizations/styled/

ln -s /var/cpanel/customizations/styled/ABC_Hosting default_style

In the event that root will specify a default_style in the manner indicated above, both cPanel and WHM will revert to this setting when a preference for users and resellers are not found.

Step 2. Disable the style-changing option for users.

In the customer’s package, you will find there an option named “Change Style”. Just unmark the checkbox so that users will no longer be able to see the interface and set another style aside from the one you developed.

Going for Paper Lantern’s Very Own Retro Style

In the event that you want to go with the Retro Style that comes along with Paper Lantern, all you need to do is the following:

1. Go to your cPanel account.

2. On the top navigation pane, select the pulldown menu for “User Preferences” and then click on “Change Style”.

3. Choose the “Apply” option for the Retro style.

After this, the browser will refresh and the cPanel dashboard that will load will already be in the Retro style. The changes will automatically be saved, which means that the next time you log in to this account, Paper Lantern’s Retro style will greet you.

Assigning the Retro Style for a cPanel Account through a Command

You also have the option to change a cPanel account’s theme to the Paper Lantern Retro style through the following steps:

1. Go to the home directory of the cPanel user and check if this is already existing: /home/username/var/cpanel/styled. If it is not, then create one.

2. Make a symlink and name it “current_style”. This should be pointed to /usr/local/cpanel/base/frontend/paper_lantern/styled/retro:ln -s /usr/local/cpanel/base/frontend/paper_lantern/styled/retro current_style

Applying the Retro Style to All Single-Reseller-Controlled cPanel Accounts

For reseller who want to have the cPanel accounts of their customers feature the Retro Style, here are the steps to do it:

1. Sign in to cPanel and choose the pulldown menu for “User Preferences”.
2. Select “Change Style”.
3. Click the option for “Choose Default” for the Retro style.

Paper Lanter’s Retro Style is the latest style for cPanel users, and it brings with it a lot of benefits. So for you and your clients to enjoy all the good it has to offer, consider applying the changes now. Just follow the directions listed above, and you (and your clients) will soon find yourself faced with  an impressive and easy-to-navigate interface.