Customising Roundcube

[christbate]

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

[cPanelDavidG]

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.

[sirbrent]

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.

[cPanelDavidG]

...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).
...

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).

[sirbrent]

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.