Roundcube Community Forum

Could someone take pity on a NOOB and write up a clear, thorough, simple step-by-step guide to setting up the PASSWORD plugin for RoundCube on a hosted account with CPanel?  (I think, that's what we need.  Our site is hosted on HostMonster.com basic plan).

I've managed to get a working RoundCube set up, with our own theme customized for our site, and so far it's fine... works great as basic plain vanilla setup (except for the custom theme). 

I've never tried adding any plugins to this, so far, and kinda unsure how to do it at all. 

I really don't want to mess up the RC install as it is!  But it would be *nice* if our users could change their own password rather than having to have me do it manually thru the web hosting Admin CPanel...

Any help/advice will be much appreciated.

-John C.

This is how you should fill out the data for the password plugin to work with cPanel:

In <RC root>/plugins/password/config.inc.php
Set password_driver to cpanel:

Quote$rcmail_config['password_driver'] = 'cpanel';

Login to cPanel and when on the main page look at the url, it should look something like:

Quotehttps://example.com:2082/frontend/x3/index.html

This is the data needed:

Quotehttps://Host:Port/frontend/Theme/index.html

This is what it should look like in the config file:

Quote$rcmail_config['password_cpanel_host'] = 'Host';

$rcmail_config['password_cpanel_username'] = 'Your cPanel username';

$rcmail_config['password_cpanel_password'] = 'Your cPanel password';

$rcmail_config['password_cpanel_port'] = Port;

$rcmail_config['password_cpanel_ssl'] = true;

$rcmail_config['password_cpanel_theme'] = 'Theme';

Hi, thanks for that... I think I got it.  So... in the file renamed config.inc.php under the CPanel section I have:


// cPanel Driver options
// --------------------------
// The cPanel Host name
$rcmail_config['password_cpanel_host'] = 'host359.hostmonster.com';
// The cPanel admin username
$rcmail_config['password_cpanel_username'] = 'myusername';
// The cPanel admin password
$rcmail_config['password_cpanel_password'] = 'mypassword';
// The cPanel port to use
$rcmail_config['password_cpanel_port'] = 2083;
// Using ssl for cPanel connections?
$rcmail_config['password_cpanel_ssl'] = true;
// The cPanel theme in use
$rcmail_config['password_cpanel_theme'] = 'hostmonster';



...but then what?  I assume I need to edit something to add the plugin into our custom theme... or what's next?

Sorry again if it's a dumb question, I just need this dumbed down to noob level, LOL

-JC


P.S. EDIT: OK actually I figure it out... have to edit main.inc.php to ADD the password plugin to the PLUGINS section, right?

So I did that... and it worked!  Success! 

Oh... wait.... actually NO. 

Another problem:  Adding this plugin seemed to BREAK the only *other* plugin I've added to our RoundCube setup, which was the "Persistent Login" tweak.  That was there too in the main.inc.php section for plugins, and working fine.  But now that I've added the password line, it stopped working :(

So... what to do about that?

==========

EDIT again:

Whoops... OK, so I figured it out myself again.  LOL

The line for plugins should have been:


// List of active plugins (in plugins/ directory)
// $rcmail_config['plugins'] = array();
$rcmail_config['plugins'] = array(
   'persistent_login',
   'password' );


...and at first I had stupidly put the new text on it's own line rather than inside the array.  Duh.

So, okay, seems like everything's working now.  Thanks for help :)

-JC

Um... me again.  Back with another thing.

As noted above, I got this working.  And yeah, it works... but it kind of doesn't LOOK very good.

Seems to me like this plugin isn't really very well integrated with the RoundCube theme, design-wise.

Here's what it looks like now (screen shot of it in our customized theme which is based on the default theme):
.           (See FIRST attachment, below... filename OldDesign.jpg)

But here's a mock up of what I think would be better:
.           (See SECOND attachment, below... filename NewDesign.jpg)

The "Change Password" feature doesn't really need it's own TAB now, does it? 

And the way it looks, now, it's kind of jarring that the UI element for it spans across the whole screen area.  Not necessary.  This should really fit in fine as just another line-item in Preferences.

However, I have NO IDEA how to go about making this change. 

Any suggestions which files need to be edited, etc?  Or maybe someone's already done this and can share the edits here?

Thanks in advance :)

-JC

I agree that it could be better placed on the Preferences tab. It doesn't help that you have a different colored background it makes it stand out far more. The tab is in the password.js file, if you know JS it should be pretty easy to change out.

Yeah I realize the dark background does make it worse, but that's our theme/style so the email app is integrated in our site.

I'm really no good with JavaScript, other than making an occasional tweak on someone else's code here or there (and even then mainly just cosmetic, design-related stuff, not actual code hardly.  Mostly I'm only a UI guy not actual programmer unfortunately).

So maybe something like THIS (below...) would be easier?
.           (See THIRD attachment, below... filename NewDesign2.jpg)

This keeps the current code for putting all this on it's own TAB but just replicates the sub-window (?) design like on Preferences, Folders, and Identities tabs, but with just one menu item "Change Password" to click (same like Identities when you only have one to choose).

Any hints how to do this, maybe it's easier if it's just duplicating the layout of an existing file?

-JC