Branding/Skinning question

[cPanelDavidG]

Originally Posted by brianc

Thanks for the reply but it doesn't answer my question. How can I add additional sections to cpanel to market my own services? Large companies such as Bluehost do this with their cpanel installation so the ability to do this is apparently there but I don't see any documentation that shows how one can do this.

Do you know if this ability will be coming back to the branding editor in the future? Why was it removed in the first place?

Please see the PM I sent you .

[Roxanne]

Originally Posted by brianc

I can use the branding mechanism to modify the header/footer to my needs. However I would like to add an additional section or box to the skin. Right now there are sections for preferences, mail, files, logs, security, etc. How do I go about adding a new section that will contain custom icons/links that we want to put in? Does the branding function allow for this or do I need to clone the x3 theme?

Wow, how immature can you get BrianC? Maybe you need to re-read your own question before speaking your mind. In "general" (which it is) are questions are THE SAME THING. You're looking to find out how to create an additional "box" with a list of custom icons/links, as I am too, only I'm wondering if I can just add the custom icons/links instead of a whole new box. In the end we are both trying to find out how to put in our own custom fields. What is so different about that, please for the love of God tell me?

DavidG if you can please PM the solution or post it here, I would be eternally grateful.

[brianc]

Please calm down and relax and stop attacking me. I have not attacked you nor thrown any insults your way.

As I said before, I am looking to add a custom section, not just icons. So yes our goals are different and it would be polite if you just begin your own thread and stop hijacking others with your own questions.

[Roxanne]

Trust me, I am very calm and relaxed. I'm not trying to "attack" you in any way, so please excuse me for my "immature" comment, I felt that your last post just demonstrated it. I just feel that our questions are the same even though I'm trying to get custom icons/links and you're trying to get that and a new box in Cpanel. I figured that if your question was met with a solution I could work with it and achieve the same goal. Do you get me now? Excuse me for asking the second question and getting it answered through out this thread, I can understand what you mean with that, but my original question I'm sure can be done with the solution for your question.

[cPanelDavidG]

Originally Posted by Roxanne

DavidG if you can please PM the solution or post it here, I would be eternally grateful.

EDIT: I know many people are now referencing this thread. Please scroll down further to my next post for a better solution than the one in this post.

---

Giving it some consideration, since there are big scary messages at the top saying to use this functionality at your own risk, it is not supported by our support team - I don't see any issue with sharing this publicly so long as you are mindful of this message.

If you point your browser to ip:2082/frontend/x3/resellers/branding/elementadd.html (where IP is your IP address), you can add icons to the interface.

To remove an element, go to: ip:2082/frontend/x3/resellers/branding/elementdelete.html

To create a new section, simply reference a section that does not exist by default in the X3 interface. If you wish to add something to a section that does exist, section names are rather self-explanatory if you explore the CSS of these various sections with a CSS inspection tool such as Firebug.

Note, you will need to do this within a reseller's account. End users do not have this functionality. Typically, you cannot login to the cPanel interface using root login credentials.

[brianc]

Now why did you have to go ahead and share that David? I was hoping to charge Roxanne a large fee for this information!

Well Roxanne now it looks like we both can be happy campers. Still friends?

[Roxanne]

Originally Posted by cPanelDavidG

Giving it some consideration, since there are big scary messages at the top saying to use this functionality at your own risk, it is not supported by our support team - I don't see any issue with sharing this publicly so long as you are mindful of this message.

If you point your browser to ip:2082/frontend/x3/resellers/branding/elementadd.html (where IP is your IP address), you can add icons to the interface.

To remove an element, go to: ip:2082/frontend/x3/resellers/branding/elementdelete.html

To create a new section, simply reference a section that does not exist by default in the X3 interface. If you wish to add something to a section that does exist, section names are rather self-explanatory if you explore the CSS of these various sections with a CSS inspection tool such as Firebug.

Note, you will need to do this within a reseller's account. End users do not have this functionality. Typically, you cannot login to the cPanel interface using root login credentials.

Thank you very much, and no problems there, I have a whole private server to test this out with. =D

BrianC *shakes Hand* Truce

[handsonhosting]

Yay - an answer

I had only just started my hunt for this today, and read the posts just HOPING that there was a final solution. This is

Thank you guys for posting this, it's much appreciated.

[cPanelDavidG]

For those desiring an officially supported solution, here's a follow-up:

Note, this does rely on JavaScript. Making an actual plugin to eliminate the JavaScript requirement is not difficult, but this should work for the majority of users.

You can use the cPanel Plugin Generator to add your own icons to the cPanel interface. You don't need to make an entire plugin to use this generator if you merely want to redirect to an external page.

For my example, I am going to create an icon in the cPanel interface that redirects to cPanel.net/security

The first thing I need is an icon. So I just take my little forum avatar and download it to my computer.

Then I go to the cPanel Plugin Generator at: http://www.cpanel.net/plugins/devel/installgen.html

For name of plugin, I give it an internal name. It shouldn't have spaces and none of your users should ever see this. I am calling mine redirector. For module description I use Icon for cPanel Security Page.

I do want this in Feature Manager, in case I want to remove it from a feature list for some reason or anther. However, if you don't want resellers to have the ability to disable this functionality, uncheck the box for Feature Manager.

The Display Name is what the actual end-user will see. For this I use Visit cPanel Security Page. This is a security thing, so I'll put it in the Security display group. For display order, I'll keep the default value to let it be the last icon in that section. For Access URL, just keep the default value. Don't worry that the default value doesn't exist.

Anchor content is where we are going to put the code that will redirect the user to the URL we want them to go to. Here, I type this Javascript code:

onclick="window.location='http://www.cpanel.net/security';return false;"

window.location='...' tells the web browser to display this URL instead.

return false; tells the browser to stop requesting the plugin URL, only focus on the I told it to go to in the previous Javascript code.

For Plugin Icon, I click browse, find the icon I want to use (which I previously downloaded). Then click submit. After you click submit, you will be prompted to download a file. Download that file, it is the installation file for your plug-in. Once the plug-in is on the server, follow the instructions at: http://www.cpanel.net/plugins/devel/install.html

Be sure to execute those commands as root (or at least sudo). Executing as a normal user will not result in a functioning plugin. Additionally, I highly recommend executing the command to refresh sprites (mentioned in that documentation). Now just refresh your cPanel interface to see the new icon. You can just leave the installation file in that directory, no need to delete it or anything.

I know this looks very long, but after you do it once, you'll realize it's quick and easy. Additionally, this lets you do things on a package-specific level rather than at a branding level, thus giving you easier control over who sees what.

[jols]

Originally Posted by cPanelDavidG

Please see the PM I sent you .

Dear cPanelDavidG,

We are intensely interested in this as well. Would you please PM use too? Thanks.

[cPanelDavidG]

Originally Posted by jols

Dear cPanelDavidG,

We are intensely interested in this as well. Would you please PM use too? Thanks.

Until we have official support for adding a custom group, your options are to add the appropriate CSS before or after the call that displays the icons for the cPanel interface.

So to put a custom section which by default always appears above the other sections, add the following code after <div id="boxes">

<div id="myGroup" class="itembox">
  <div id="myGroup-bdrop" class="celldrop"> </div>
  <div class="cellbox">
    <h6   
      id="myGroup-header" 
      title="Double click to collapse/expand.  Click to drag." 
      style="clear:none;" ondblclick="rollbox(this);" class="ie-hover">
      <div id="myGroup-expander"  class="box-collapse-control" 
          style="float:right" onClick="rollbox(this);"> </div>
      myGroup Section Title
    </h6>
    <div id="myGroup-body">
      HTML to go in this custom section.
      <div class="clearit"> </div>
    </div>
  </div>
  <div id="myGroup-adrop" class="celldrop"> </div>
</div>

I just used myGroup as an arbitrary name. You can use any name as long as it isn't used by any of the pre-existing sections.

To have this always appear at the bottom by default, just put the code after that API call.

At this time, there is no method of storing the location the user drags these sections so they always appear where the user has dragged them. Though I heard from one customer that modifying the h6 tag allowed them to disable the drag/drop functionality.