Horde Groupware Webmail Edition

[davidfuzzylime]

I read in the release notes for 11.28 that Horde Groupware Webmail Edition is now a part of the system. My question's probably fairly daft - but how do I access it? I've upgraded to 11.28 and checked the version number of Horde installed, which is showing as 1.2.7.cp3 - but if I log in at https://mydomain.com:2096/ then I still just get the old-style Horde. Any suggestions for what I'm doing wrong?

[cPanelTristan]

I believe the customization required actually involves making changes yourself based on our documentation:
Customizing Horde Groupware Webmail Edition

We also discuss the changes for Horde Groupware Webmail Edition here:
cPanel & WHM 11.28 Release Notes - Horde Groupware Webmail Edition

This indicates the change is basically sharing capabilities not the interface. Again, you can customize the interface using the previous documentation, though.

[davidfuzzylime]

Ah cool, so it's more that it's supported than anything else. Thanks!

[johnburk]

Thank you cPanelTristan

I was also surprised when upgrading to 11.28

The new horde in cPanel seemed like a step back. No HTML email viewing support. Problems with attachments, no threat support and many more missing options.

So I am going to start customizing it to get the basic core features back.

[cPanelDon]

Thank you cPanelTristan

I was also surprised when upgrading to 11.28

The new horde in cPanel seemed like a step back. No HTML email viewing support. Problems with attachments, no threat support and many more missing options.

So I am going to start customizing it to get the basic core features back.

Please keep in mind that it's the latest version of Horde available. If there is a specific feature desired or symptom being experienced I recommend searching the official Horde web site to determine if a resolution is available: The Horde Project and Horde Groupware Webmail Edition

I verified that in Horde it is possible to view an e-mail in HTML format, both inline or via a link to click. For the method where a link can be clicked to view HTML, please check the following preference that may be set after logging-into Webmail: Horde >> Mail >> Options >> Message Options >> Message Viewing >> Where do you want to display links to alternative formats of a message?

To display HTML messages in-line, it may require a configuration adjustment to Horde, as noted by the Horde IMP "INSTALL" documentation, (located at "/usr/local/cpanel/base/horde/imp/docs/INSTALL"): * By default, IMP is configured to NOT display text/html message parts inline. This is done for various security reasons. If you would like to see text/html parts inline, you must make this change in ``imp/config/mime_drivers.php``::

$mime_drivers['imp']['html']['inline'] = true;

Reference: IMP Documentation - Installing IMP - Configuring IMP - IMP Configuration Pointers

When searching the Horde web site I found the following Wiki entry that offers additional clarification and more verbose information: Wiki :: FAQ/Admin/Config - Horde Administrator's FAQ - IMP configuration - Can IMP show attachments or HTML inline?

Can IMP show attachments or HTML inline?

IMP is capable of showing certain attachments inline (i.e., in the message body, rather than appearing in a new window on request), but in some cases it risks exposing the user to a security problem in the browser: by enabling inline HTML, any JavaScript (ActiveX, Java, etc.) in the attachment might be executed by the browser. We try to filter out any active content, but just like with any filter, it might not be perfect and let some code through. Enabling inline HTML attachments is discouraged.

Of course, this will only work for elements that could be part of a regular HTML page. In particular, images cannot be part of in a regular HTML page (they have to be a separate file with an <IMG> tag to include them in an HTML page), and can thus not be inlined.

Edit the files horde/config/mime_drivers.php and horde/imp/config/mime_drivers.php to enable inline support for the mime types you wish to have displayed inline. Simply set the 'inline' array element for that mime type to true to enable a type. As noted above, not all mime types can be shown inline; if there is no 'inline' array element for a mime type than that type can not be viewed inline.

For example, to enable inline HTML support you would set:

$mime_drivers['imp']['html']['inline'] = true;

Here is the location to both files mentioned in the Horde documentation:

/usr/local/cpanel/base/horde/config/mime_drivers.php
/usr/local/cpanel/base/horde/imp/config/mime_drivers.php

Here is what the aforementioned entries look like in a stock-default configuration:

• /usr/local/cpanel/base/horde/config/mime_drivers.php
  

  /**
   * HTML text driver settings
   */
  $mime_drivers['horde']['html'] = array(
      // NOTE: Inline HTML viewing is DISABLED by default.
      'inline' => false,
      'handles' => array(
          'text/html'
      ),
      'icons' => array(
          'default' => 'html.png'
      ),
      // Check for phishing exploits?
      'phishing_check' => true
  );

• /usr/local/cpanel/base/horde/imp/config/mime_drivers.php
  

  /**
   * HTML driver settings
   */
  $mime_drivers['imp']['html'] = array(
      'inline' => false,
      'handles' => array(
          'text/html'
      ),
      'icons' => array(
          'default' => 'html.png'
      ),
      /* If you don't want to display the link to open the HTML content in a
       * separate window, set the following to false. */
      'external' => true,
      /* Run 'tidy' on all HTML output? This requires at least version 2.0 of the
       * PECL 'tidy' extension to be installed on your system. */
      'tidy' => false,
      /* Check for phishing exploits? */
      'phishing_check' => true
  );

[cPanelDon]

If a new appearance for Horde is desired, I would consider switching to a different theme, such as "silver" instead of "bluewhite" -- this can be adjusted server-wide via the following configuration file:

/usr/local/cpanel/base/horde/config/prefs.php

Here is the applicable stock-default entry that may be modified to switch to a different theme:

// UI theme
$_prefs['theme'] = array(
    'value' => 'bluewhite',
    'locked' => false,
    'shared' => true,
    'type' => 'select',
    'desc' => _("Select your color scheme.")
);

I set Horde to use the "silver" theme, which is included by default; the updated configuration entry is shown below:

// UI theme
$_prefs['theme'] = array(
    'value' => 'silver',
    'locked' => false,
    'shared' => true,
    'type' => 'select',
    'desc' => _("Select your color scheme.")
);

[johnburk]

Thank you Don! Although it is not part of the cPanel support, it is very nice of you to take time to for the help.

[visskiss]

Thanks for the info. I don't think changes made to that file 'prefs.php' would stick through an upgrade, unless you provided an overlay tarball.

What I'd like to know is how to activate the sharing features...

[yayyo]

Thank you Don and Tristan,

I set : 'inline' => true, in both /usr/local/cpanel/base/horde/imp/config/mime_drivers.php and /usr/local/cpanel/base/horde/config/mime_drivers.php

It worked for a few days, but then (as hinted at by visskiss) my changes seem to have gottten overwritten (reverted) by an update.

Does anybody know, what is the best way to make those edits "stick" ?

TIA
Marty

[cpanelkenneth]

We provide documentation on this here: Customizing Horde Groupware Webmail Edition

A simple example where we want to retain cookie handling:

1. Create the following directory structure:
mkdir -p /root/horde/config

2. Copy /usr/local/cpanel/base/horde/config/conf.php.in to the /root/horde/config directory you made in step 1

3. Edit /root/horde/config/conf.php.in to change $conf['session']['use_only_cookies'] from true to false.

4. Create a tarball of the directory structure made in step 1, name the tarball overlay.tar.gz

cd /root
tar czvf overlay.tar.gz horde

5. Copy overlay.tar.gz to /var/cpanel/horde on your cPanel server

6. Execute /usr/local/cpanel/bin/update-horde You should see output like the following:

$ ./bin/update-horde 
Updating Horde 1.2.8.cp4
tar -x -p -z --no-same-owner -f /usr/local/cpanel/src/3rdparty/gpl/horde-webmail-1.2.8.tar.gz
patching file config/conf.php.in
patching file dimp/config/conf.php
patching file imp/config/conf.php
patching file imp/config/servers.php.in
patching file imp/lib/Compose.php
patching file imp/lib/IMAP.php
patching file imp/templates/login/login.html
patching file imp/test.php
patching file ingo/config/conf.php
patching file ingo/test.php
patching file kronolith/config/conf.php
patching file kronolith/test.php
patching file lib/Horde/Kolab/IMAP/test.php
patching file lib/Horde/Kolab/Server/test.php
patching file lib/Horde/Prefs.php
patching file lib/Horde/Registry.php
patching file mnemo/config/conf.php
patching file scripts/sql/groupware.mysql.sql
patching file templates/login/login.inc
patching file test.php
patching file turba/config/conf.php
patching file turba/test.php
Using Horde overlay (using local version)tar -x -p -f /var/cpanel/horde/overlay.tar.gz -C /usr/local/cpanel/base
...

7. Your cookie setting should now be preserved

[johnburk]

Thank you for the detailed 7 steps.

How can this be done when 2 files need to be edit. For example

/usr/local/cpanel/base/horde/config/mime_drivers.php
/usr/local/cpanel/base/horde/imp/config/mime_drivers.php

On step 2. I get stuck because both files have the same name. So how can I keep both settings for the next update?

[cpanelkenneth]

Thank you for the detailed 7 steps.

How can this be done when 2 files need to be edit. For example

/usr/local/cpanel/base/horde/config/mime_drivers.php
/usr/local/cpanel/base/horde/imp/config/mime_drivers.php

On step 2. I get stuck because both files have the same name. So how can I keep both settings for the next update?

The names are the same, but the paths are different. Merging your request with my example, in step 1 you would do:

# mkdir -p /root/horde/config
# mkdir -p /root/horde/imp/config

Then you would copy/create the files in the appropriate directory within /root/horde/

With the overlay approach, you need to mirror as much of the /usr/local/cpanel/base/horde directory structure as necessary in your working overlay directory (/root/horde in my example) to retain your desired configuration.

[johnburk]

Thank you. I did not realize it was that simple.

[cpanelkenneth]

Thank you. I did not realize it was that simple.

You're welcome.

[sneader]

I have a customer that would like to use the new 'shared calendar' feature of Horde Groupware. They can't figure out how to do this, and so I logged into my own webmail account and sure enough, I'm lost. I went to Horde's website, and I cannot find any documentation on how to actually use the Groupware feature.

Do I have to do something to "have" Groupware?
Are there any end-user docs? (must be somewhere, I am obviously looking in the wrong place)

Thanks!

- Scott