The Community Forums

Interact with an entire community of cPanel & WHM users!
  1. This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn More.

Customising Roundcube

Discussion in 'User Experience' started by christbate, Sep 18, 2008.

  1. christbate

    christbate Registered

    Joined:
    Sep 18, 2008
    Messages:
    1
    Likes Received:
    0
    Trophy Points:
    1
    Hi, We have a cPanel 11 installation with the roundcube web mail client, and customised the look by editing the base files for roundcube via ftp.

    This, however, was overwritten with the original installation files when cPanel did an updating cron job.

    I assume to stop this happening again, we need to build our customisation as a new theme or skin for roundcube, but can't find any documentation on how to do this.

    Is this handled by the 'theme balls' inside cPanel, or is it something else?

    Thanks
    Chris
     
  2. cPanelDavidG

    cPanelDavidG Technical Product Specialist

    Joined:
    Nov 29, 2006
    Messages:
    11,279
    Likes Received:
    8
    Trophy Points:
    38
    Location:
    Houston, TX
    cPanel Access Level:
    Root Administrator
    Generally, when people have customizations they wish to preserve, I recommend using some of our hook scripts. In this case, you are concerned with /scripts/upcp - well you can create /scripts/preupcp to backup your customizations and create /scripts/postupcp to restore the customizations.
     
  3. sirbrent

    sirbrent Well-Known Member

    Joined:
    Sep 30, 2008
    Messages:
    98
    Likes Received:
    1
    Trophy Points:
    8
    WHM has no support for RoundCube themes/skins. However, Roundcube does support theming. You can just copy the skins/default directory as a template, make your changes and then anytime roundcube is overwritten reupload the template directory. You could also perhaps do a cron for this. Might I suggest though, turning off automatic updates through whm. and then you can just update when you want (say once a month) and reupload the theme then (rather then risking whm having done an autoupdate and you not catching it to upload the theme again).

    You could also remove WHM completely from the roundcube issue and just install around roundcube stand-alone (as not integrated into whm) and make a subdomain/zone to point your webmail.whatever.com's to the installation. A little more complicated that way though.
     
  4. cPanelDavidG

    cPanelDavidG Technical Product Specialist

    Joined:
    Nov 29, 2006
    Messages:
    11,279
    Likes Received:
    8
    Trophy Points:
    38
    Location:
    Houston, TX
    cPanel Access Level:
    Root Administrator
    An easier and more efficient way of doing this without having to disable automatic updates is to handle this is creating a /scripts/postupcp script to handle this (rather than cron job).
     
  5. sirbrent

    sirbrent Well-Known Member

    Joined:
    Sep 30, 2008
    Messages:
    98
    Likes Received:
    1
    Trophy Points:
    8
    also, as a side note you can save your customizations to a new "skin" (theme) by going to the roundcube installation folder (/user/local/cpanel/base/3rd party/roundcube) and then into the skins folder, copy the default (or x3) skin to a new directory, make your changes. You can tell roundcube which skin to use in the main configuration file (config/main.inc.php)-- there is a variable there to set the skin directory. WHM Updates should leave the skin (that you made) directory alone, but might overwrite the skin's selection (by replacing the configuration file). The configuration file would probably be the only file youd need to replace upon whm updates.

    There are a few customizations that arent skin related though... like the page titles, which is also in the config file i mentioned.
     
Loading...

Share This Page