Please whitelist cPanel in your adblocker so that you’re able to see our version release promotions, thanks!

The Community Forums

Interact with an entire community of cPanel & WHM users!

Editing Paper Lantern's * templates

Discussion in 'User Experience' started by matt5840, Jul 4, 2016.

  1. matt5840

    matt5840 Registered

    Jul 4, 2016
    Likes Received:
    Trophy Points:
    cPanel Access Level:
    Root Administrator
    Hi there,

    TL;DR, Is it possible to create a fully customized theme based off of Paper Lantern?

    Our developers have made customizations to the cPanel page "Email Accounts" (http://domain/cpanelsessionID/frontend/paper_lantern/mail/pops.html) by editing the file, located at /usr/local/cpanel/base/frontend/paper_lantern/mail/

    The issue is either the nightly upcp cron job, or nightly system update is replacing the file.

    What is the proper way to go about making this change persistent? Should we copy the Paper Lantern theme folder to clone the theme and apply our changes there and then change it to use that theme?

    From what I can gather none of the UI Includes, branding, or style customizations are sufficient for this. We need finer grain control, not just adding content to the headers and footers.

  2. cPanelKenneth

    cPanelKenneth cPanel Development Staff Member

    Apr 7, 2006
    Likes Received:
    Trophy Points:
    cPanel Access Level:
    Root Administrator
    What are you trying to add to (or remove from) the Email Accounts page? Perhaps there is a change we could make to help you accomplish that.
    Stop hovering to collapse... Click to collapse... Hover to expand... Click to expand...
  3. LBJ

    LBJ Well-Known Member

    Nov 1, 2003
    Likes Received:
    Trophy Points:
    I Just found this oldish thread while looking for something else, and although I obviously can't answer for matt5840, there are quite a few changes we've been making to the X3 and now Paper Lantern themes inside the pops.html(.tt) and pops.js (and js2-min) files.

    Along with some associated supporting hooks, the changes we make are primarily related to long-running requests made in this forum and/or in the various cPanel enhancement request locations over the years...

    1. Allow the configuration of maximum mailbox sizes based on hosting plans. We allow different maximum mailbox size quotas for different plans. This greatly increases our ability to match plans and pricing with different types of clients. Some clients want a budget account with only small mailboxes, while others are happy to pay a premium for mailboxes limited only by the total size of the plan. This alone greatly increases our revenue through plan granularity and available upgrade path incentives.

    2. Control over the "Set Up Mail Client" functions. We handle our remote outgoing SMTP services independently of our hosting boxes, so the non-configurable auto-configure options for mail accounts provided by cPanel are unusable for us as they simply create huge numbers of support requests from understandably confused end-users when their email sending fails.

    3. With Paper Lantern only, we take control over which plans allow clients to suspend their own individual email accounts. Some less knowledgeable clients have caught themselves out by bouncing email or blocking their ability to collect email after playing with the suspend options. We remove some or all of those options for more basic accounts.

    The coding required to handle the above is really quite minimal, and would be even simpler (and neater) if incorporated into cPanel directly.

    Best regards,


Share This Page

  1. This site uses cookies to help personalise content, tailor your experience and to keep you logged in if you register.
    By continuing to use this site, you are consenting to our use of cookies.
    Dismiss Notice