Skip to main content

PL documentation

Comments

25 comments

  • PCZero
    OK I just want to clear all of my customization form where I was testing this system a long time back. Nohting is working. IN WHM I cleared all the settiings in CPanel - Branding - Saved At shell I removed the .var/cpanel/customizations/styled directory structure However the one client I have set up to use PL still has the customized header etc. WTF? God I despise this very awkward and terribly cumbersome PL system. X3 was so much easier to use and customize and it had a far superior look and feel as well. Perfect example of changing something that was working just fine simply to say 'look at our new system!"...
    0
  • PCZero
    Seriously people? This is a new improved interface system PL? I ave to use jQuery, I have to manually set up directory and symlinks, I have to manually create css? The live editor was too hard for some people to use but you think this is an improvement? Then each lelel of WHM you change how it all works so I have to undo work and start over. I am stunned that anyone would think that the PL system is anywhere near as good as X3 was let alone being any degree of better. It is a horrible system that requires so much manual work that it is all but impossible to create the custom interfaces that I need for my clients. Not only that but the default PL look and feel is absolutely the ugliest and most awkward UI that I have seen in my years of computer work stating in the early 80s. The entire PL team should be fired and banned form ever even using a computer ever again in their lives. Huge fail.
    0
  • PCZero
    I cleared all the setting in WHM under branding. If that does not accomplish the desired task of getting rid of custom settings why is it even there? Why is it so much harder to modify PL than it was to modify X3? This is a HUGE step backward in usability. While the intention of PL may have been admirable, the implementation of it is one of the worst projects designs I have seen in my 30+ yeras of computer use. All that is in brand is reseller_info.json there is also an includes directory with two .tt files. Why is this so damn complicated? You guys took a system that was really easy to use and great for making custom themes and replaced it with a cumbersome awkward and extremely limited system that does not even work! BTW I do not have resellers
    0
  • PCZero
    BTW thanks for the link but that 'tutorial' is way too complicated. No where near as easy as going into WHM and using X3 live editor, according to some of the programmers at cPanel is too difficult to use as compared to this very awkward and manually intensive crap that we haev to go through to manage PL.
    0
  • Infopro
    What part of the documentation linked above are you having issues with exactly?
    0
  • PCZero
    The fact that it is incomplete (it does not cover how to properly remove changes and delete customizations, what is safe to delete and what is not etc). That following it does not always work. The fact that going through all of that bullshit is unnecessary had PL been developed to work with the ease of X3 through the WHM interface.
    0
  • Infopro
    You'd remove changes by deleting the directory you created in Step #1, and then moved in step #5. Assuming you moved it to be used by a single cPanel user, for testing: To apply a style to a specific account through the cPanel interface, perform the following steps: Log in to cPanel as the desired user. Navigate to cPanel's Change Style interface (Home >> Preferences >> Change Style). Click Apply for the desired style.
    You could go back there and select Basic and be back on Paper Lantern.
    had PL been developed

    Paper Lantern is the most advanced cPanel style ever developed. Making custom styles can be tough. Wordpress, xenforo, you name, all have their pain points. Making a simple style for cPanel is not so hard. And cPanel is continually working to make using, and customizing Paper Lantern better. Have you seen these starter styles you can grab, upload, and edit as you like? Free cP Starter Style | cPanel Blog Or this blog post showing how to easily brand your cPanel in several ways? cPanel Branding Basics: A Guide for Reseller Hosts | cPanel Blog That editor you speak of that was in x3 is not coming back. Please feel free to ask for assistance with anything you get stuck on along the way. Also, please try and be more friendly in your posts. Your frustration is no reason to beat up on the cPanel team.
    0
  • PCZero
    Did those steps but the custom header is still in place. Define advanced... Complicated - yes. Has the best feature set and ease of use - FAR FAR FAR form it. Citing something as lame as wordpress goes to prove my point. Too bad that you guys seem to think that this cumbersome, limited, labor intensive system is anywhere near better than X3 just because your development team wasted a massive amount of man hours coming up with it.
    0
  • PCZero
    Yet another issue. How do I set up PL so that I can have multiple custom styles like I could in X3 and then limit my clienst to being able to select ONLY my custom styles (again as I could in X3)? These are not advanced or enhanced request. They are requests for basic standard functionality. What good is a series of custom styles if you cannot limit your users to selecting one of them?
    0
  • PCZero
    Lastly, if I want to use the canned Retro style as a starting point for a custom style, where would I find all of the code and resources for that style and what would be the easiest method to close it into a number of a custom styles?
    0
  • PCZero
    I downloaded both of those styles and uploaded them to my server. When I go to the one client account that is patiently testing PL, they both show up when he clicks the Change Style option, however the new styles are never applied. I do NOT want either of these to be the default style so I have not set either one to be such. Please tell me how to get these new styles active and as I asked above how do I disable the two canned styles and only offer my custom styles.
    0
  • Infopro
    Did those steps but the custom header is still in place.

    Assuming you had a custom Paper Lantern style go wrong, and you followed those steps and changed back to the "Basic" style as suggested, I'm unclear on how the custom header could still be in place unless it was being cached, or you edited the Basic style.
    Define advanced...

    Works on my iPhone and my HD desktop monitors. We never had an x3 style that could do that. For starters.. :)
    Complicated - yes. Has the best feature set and ease of use - FAR FAR FAR form it.

    Not sure where you read those comments, wasn't me.
    Citing something as lame as wordpress goes to prove my point. Too bad that you guys seem to think that this cumbersome, limited, labor intensive system is anywhere near better than X3 just because your development team wasted a massive amount of man hours coming up with it.

    I have nothing to do with Paper Lantern other than providing feedback, just like you. That, and I enjoy having it being constantly improved on as has been the case for some time now. It just keeps getting better. But it is not x3 you're right, x3 is dead.
    0
  • Infopro
    Yet another issue. How do I set up PL so that I can have multiple custom styles

    In the blog post I linked you to, there are 2 styles offered as you'll recall: Free cP Starter Style | cPanel Blog The path to those files mentioned would be: /home/username/var/cpanel/styled/cP_Starter_Light/ And if you wanted to use both, the dark one might be placed here: /home/username/var/cpanel/styled/cP_Starter_Dark/ Seems straight forward so far.
    like I could in X3 and then limit my clienst to being able to select ONLY my custom styles (again as I could in X3)? These are not advanced or enhanced request. They are requests for basic standard functionality. What good is a series of custom styles if you cannot limit your users to selecting one of them?

    This request is one that you've been asking about for as long as Paper Lantern has been available. Your Feature Request is here in case anyone reading this wants to vote on it: Add More Control to Paper Lantern and Custom Styles
    Lastly, if I want to use the canned Retro style as a starting point for a custom style, where would I find all of the code and resources for that style and what would be the easiest method to close it into a number of a custom styles?

    I believe the details in this blog post are still accurate and explain where retro is located: The Retro Style for Paper Lantern arrives with 11.48 | cPanel Blog usr/local/cpanel/base/frontend/paper_lantern/styled/retro/
    0
  • PCZero
    Got the two sample styles working. There are some flaws though, but they are part of PL not the styles. For instance, the main menu (Home - Edit Contact Information - Change Your Password - Reset Page Settings - Contact Support) jump around as you go to sub pages. This is a result of the frames/divs being messed up it appears. On the main page that menu spans the entire width of the screen and is center on that width. On the sub pages, it only spans a portion of the screen and thus the text is center on a smaller width making it jump to the left. Sorry I misquoted when I said complicated, I was addressing your comment that it is "advanced". I am not sure what you mean by advanced but PL lacks a LOT of the functionality and ease of use that X3 had and that is not deniable by anyone. FYI: No real admin uses an iPhone to administer his server. I still do not see how to disable the option for the users to select the default or retro styles and thus limit them to using my custom styles only. That is absolutely doable. I have no idea why it is not a feature.
    0
  • PCZero
    This request is one that you've been asking about for as long as Paper Lantern has been available. Your Feature Request is here in case anyone reading this wants to vote on it: Add More Control to Paper Lantern and Custom Styles

    And yet as simple as it would appear to be to add this basic fucntionality that was removed for some reason why has it not been addressed yet?
    0
  • PCZero
    Why should people have to vote to add basic functionality that was arbitrarily removed? I have heard no response at all on that simple basic request so of course I will still ask about it!
    0
  • Infopro
    FYI: No real admin uses an iPhone to administer his server.

    This comment is just plain silly, I'm sorry, I disagree.
    And yet as simple as it would appear to be to add this basic fucntionality that was removed for some reason why has it not been addressed yet?

    Well, I can't properly answer why your request only got 3 votes, either. One of them mine, BTW. I can guess though. If all else fails, you might want the system to have Paper Lantern to fall back on if your custom style was to break for some reason. I'm guessing of course. I would only add a quote from Adam here I think is relevant: Forget the name "Paper Lantern" moving forward. Just think of it as the modern cPanel UI. @cPanelAdamF
    Its the default UI. It sounds like those custom styles you added from the blog post are not up to date with the latest changes to Paper Lantern. Too late at night for me to check now, but I will add them to my new stage server and see, in the AM. TBH, I'm not sure what can be done if that's the case, we may be on our own to update it.
    0
  • PCZero
    I just tried cloning the usr/local/cpanel/base/frontend/paper_lantern/styled/retro/ style to /var/cpanel/customizations/styled/ABCD01 and it is not working correctly. The cloned style is using half of the standard default PL style and half of the Retro style, also it has no icons. What step(s) am I missing?
    0
  • Infopro
    I'm not sure if you can clone retro like that.
    0
  • PCZero
    Infopro 1st off thank you very much for helping me work through all of this. I REALLY am trying to make PL work for my clients and my setup here. It is just very frustrating that this new system is more cumbersome to use and customize. Anyway I really want to be able to do two things... 1) As my early on request asked, I need to be able to limit users to my custom styles. I am actually stunned that this is not an extremely high volume request. It does seem though that it would be pretty simple to add a on/off parameter (settable in WHM) for displaying the two canned styles when the user selectes the change style option in cpanel. It would seem a simple "if (showcannend = 1)" line to the code to test if the parameter is on or off and then either include or do not include the the two styles in the list available. I do not know the WHM/Cpenal code at all or else I would jump in and code it myself. 2) It would be a huge help if there was a way for me to use the canned retro style as a starting point for a custom style. That may actually be possible and it may be that I just am not aware of the procedure to do it. Anyway adding in these two options would make things a LOT better off for me and I believe many other users as well. Thanks!
    0
  • PCZero
    I appreciate the thoughts but I think PL is far from "modern". It may be the current incarnation but it has shortcomings that severely hamper it from being as good an all around system that X3 was, the particular preferences of the look and feel aside.
    0
  • PCZero
    I have another quick question. I am testing PL once again (hopefully I can get it to where it fits my needs). I want to set a default style and see the command line to create that sym link but I do not see where in the server to actually create it (for a default at the server level). Where do I create this symlink?
    0
  • cPanelMichael
    I have another quick question. I am testing PL once again (hopefully I can get it to where it fits my needs). I want to set a default style and see the command line to create that sym link but I do not see where in the server to actually create it (for a default at the server level). Where do I create this symlink?

    Hello, You can actually use the following UAPI function this action: UAPI Functions - Styles::update - Software Development Kit - cPanel Documentation EX:
    uapi --user=username Styles update type=default name=example
    This will set the default style for a cPanel account, and you could setup a loop that runs the command for all users on the system, like referenced in this thread: Change All Accounts From Retro to Paper Lantern? Thank you.
    0
  • PCZero
    OK maybe I am not following how it all works,. What I want to do is pick a particular PL style and set it as the global default for all existing and any new accounts so that if an account holder has not selected a PL style, my desired default will be used with having to set them to anything in particular. Is this possible? Make that WITHOUT having to set them to anything in particular.
    0
  • cPanelMichael
    What I want to do is pick a particular PL style and set it as the global default for all existing and any new accounts so that if an account holder has not selected a PL style, my desired default will be used with having to set them to anything in particular. Is this possible? Make that WITHOUT having to set them to anything in particular.

    Regarding the default style for new accounts, this thread should help: Paper Lantern theme isn't working at all Regarding the style for existing accounts, this thread should help: Change All Accounts From Retro to Paper Lantern? In addition, here's some additional information regarding some changes in cPanel version 60 that you are likely to find helpful: WHM's Branding interface (Home >> cPanel >> Branding) is now WHM's Customization interface (Home >> cPanel >> Customization). In addition, this interface now includes the following new features: [LIST]
  • You can upload, download, view, and delete styles for the Paper Lantern theme. Previously, this functionality was only available via the command line.
  • You can select the default style for new accounts.
    Thank you.
  • 0

Please sign in to leave a comment.