hmail_pop3 plugin


hMail fetch External POP3 Accounts

downloaded


hmail_pop3 plugin is a gateway interface between Roundcube Webmail and hMailServer PHPWebAdmin to allow users to download messages from POP3 accounts on other servers. Email downloads are delivered to a specific account, but it is possible to redirect them to an external account, using rules. Documentation regarding hMailServer External Accounts is available on their website for more details.

Requirements

Please note that a functional hMailServer PHPWebAdmin is required in order to use hmail_pop3 plugin with Roundcube Webmail.
hmail PHPWebAdmin default language must be set to « english » in ./PHPWebAdmin/config.php, ($hmail_config['defaultlanguage']=’english’).
Hosting PHPWebAdmin

PHPWebAdmin can basically reside anywhere on the net. Hence administrators can have this plugin in action either on a Windows Server or on a *NIX box. From a security stand point, PHPWebAdmin has a quite secure session handling and our plugin is able to pass any kind of additional HTTP Authentication (BASIC, DIGEST, … everything that cURL supports). Administrators have the following choices to connect to PHPWebAdmin:

  • LAN HTTP | LAN HTTPS
  • WAN HTTP | WAN HTTPS (recommended)

hMailServer PHPWebAdmin addition

By default, hMailServer PHPWebAdmin does not include the SSL support option for POP3 connections. Administrators can download these files to implement this feature. Unzip the archive into you PHPWebAdmin folder.

This feature addition has been created for PHPWebAdmin bundled with hMailServer 5.3.3. It also works with hMailServer 5.4.x releases (still in Beta stage). Generally speaking, it should work for PHPWebAdmin 5.x versions but it has not been tested.

Installation


hmail_pop3 plugin can be downloaded from Plugin Manager Center. Upload the hmail_pop3 plugin folder downloaded from our mirror servers (after you’ve un-zipped it) into Roundcube’s ./plugins folder and proceed to configure the plugin as usual.

Configure ‘hmail_pop3′ plugin


  • make a copy of config.inc.php.dist file in its same directory and rename the new file to config.inc.php
  • edit the new created config file …/plugins/hmail_pop3/config.inc.php:

Sample config.inc.php configuration:

/* navigation config (requires settings plugin) */
$GLOBALS['settingsnav']['hmail_pop3'] = array('part' => '', 'label' => 'externalaccounts', 'href' => './?_task=settings&_action=plugin.hmail_pop3&_framed=1', 'onclick' => '', 'descr' => 'hmail_pop3');

/* Url to hMailserver web administration interface */
$rcmail_config['hmail_webadmin_url'] = 'http://hmail.mydomain.tld';

/* In cases where http authentication is required to access hMailserver web administration interface */
$rcmail_config['hmail_webadmin_http_user'] = 'http_username'; // false if no http authentication required
$rcmail_config['hmail_webadmin_http_pass'] = 'http_password';

Working with External POP3 Accounts in Roundcube Webmail


Login to Roundcube Webmail. Enable Settings -> Manage Plugins -> External POP3 Accounts if not enabled by default. Manage/Add/Remove External POP3 Accounts from Settings -> Account Administration -> External POP3 Accounts.

hmail_pop3 plugin