2.15. Advanced Zarafa WebAccess configurations

2.15.1. Zarafa WebAccess as default mail client

Since ZCP version 6.20 it is possible to set the Zarafa WebAccess as the default email client. Below we show three examples on associating the WebAccess with the default action for when a user clicks on an email addresses link.

2.15.2. Windows

For all users on a computer:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail\Zarafa Web Client]
@="Zarafa Web Client"

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail\Zarafa Web Client\DefaultIcon]
@="%windir%\\zarafa.ico"

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail\Zarafa Web Client\Protocols]

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail\Zarafa Web Client\Protocols\mailto]
"URL Protocol"=""

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail\Zarafa Web Client\Protocols\mailto\DefaultIcon]
@="%windir%\\zarafa.ico"

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail\Zarafa Web Client\Protocols\mailto\shell]

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail\Zarafa Web Client\Protocols\mailto\shell\open]

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail\Zarafa Web Client\Protocols\mailto\shell\open\command]
@="rundll32.exe url.dll,FileProtocolHandler http://<ZARAFA_WEBACCESS_ADDRESS>/index.php?action=mailto&to=%l"

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail\Zarafa Web Client\shell]

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail\Zarafa Web Client\shell\open]
@="Zarafa Web Client"

[HKEY_LOCAL_MACHINE\SOFTWARE\Clients\Mail\Zarafa Web Client\shell\open\command]
@="rundll32.exe url.dll,FileProtocolHandler http://<ZARAFA_WEBACCESS_ADDRESS>/index.php?action=mailto&to=%l"

[HKEY_LOCAL_MACHINE\Software\Classes\mailto]
"EditFlags"=hex:02,00,00,00
"URL Protocol"=""
@="URL:MailTo Protocol"

[HKEY_LOCAL_MACHINE\Software\Classes\mailto\DefaultIcon]
@="%windir%\\zarafa.ico"

[HKEY_LOCAL_MACHINE\Software\Classes\mailto\shell]

[HKEY_LOCAL_MACHINE\Software\Classes\mailto\shell\open]

[HKEY_LOCAL_MACHINE\Software\Classes\mailto\shell\open\command]
@="rundll32.exe url.dll,FileProtocolHandler http://<ZARAFA_WEBACCESS_ADDRESS>/index.php?action=mailto&to=%l"

For current user only:

Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\SOFTWARE\Clients\Mail\Zarafa Web Client]
@="Zarafa Web Client"

[HKEY_CURRENT_USER\SOFTWARE\Clients\Mail\Zarafa Web Client\DefaultIcon]
@="%windir%\\zarafa.ico"

[HKEY_CURRENT_USER\SOFTWARE\Clients\Mail\Zarafa Web Client\Protocols]

[HKEY_CURRENT_USER\SOFTWARE\Clients\Mail\Zarafa Web Client\Protocols\mailto]
"URL Protocol"=""

[HKEY_CURRENT_USER\SOFTWARE\Clients\Mail\Zarafa Web Client\Protocols\mailto\DefaultIcon]
@="%windir%\\zarafa.ico"

[HKEY_CURRENT_USER\SOFTWARE\Clients\Mail\Zarafa Web Client\Protocols\mailto\shell]

[HKEY_CURRENT_USER\SOFTWARE\Clients\Mail\Zarafa Web Client\Protocols\mailto\shell\open]

[HKEY_CURRENT_USER\SOFTWARE\Clients\Mail\Zarafa Web Client\Protocols\mailto\shell\open\command]
@="rundll32.exe url.dll,FileProtocolHandler http://<ZARAFA_WEBACCESS_ADDRESS>/index.php?action=mailto&to=%l"

[HKEY_CURRENT_USER\SOFTWARE\Clients\Mail\Zarafa Web Client\shell]

[HKEY_CURRENT_USER\SOFTWARE\Clients\Mail\Zarafa Web Client\shell\open]
@="Zarafa Web Client"

[HKEY_CURRENT_USER\SOFTWARE\Clients\Mail\Zarafa Web Client\shell\open\command]
@="rundll32.exe url.dll,FileProtocolHandler http://<ZARAFA_WEBACCESS_ADDRESS>/index.php?action=mailto&to=%l"

[HKEY_CURRENT_USER\Software\Classes\mailto]
"EditFlags"=hex:02,00,00,00
"URL Protocol"=""
@="URL:MailTo Protocol"

[HKEY_CURRENT_USER\Software\Classes\mailto\DefaultIcon]
@="%windir%\\zarafa.ico"

[HKEY_CURRENT_USER\Software\Classes\mailto\shell]

[HKEY_CURRENT_USER\Software\Classes\mailto\shell\open]

[HKEY_CURRENT_USER\Software\Classes\mailto\shell\open\command]
@="rundll32.exe url.dll,FileProtocolHandler http://<ZARAFA_WEBACCESS_ADDRESS>/index.php?action=mailto&to=%l"

2.15.2.1. Installing the “.reg” file

Open a text editor like Notepad.
Insert the desired registry key, where <ZARAFA_WEBACCESS_ADDRESS> should be replaced by the url of your Zarafa WebAccess.
In the Start Menu, hit Run, enter regedit, and hit Ok.
Import the just created registry key.
In Outlook 2003/2007 go to Tools > Options > Other > uncheck Make Outlook the default program for Email, Contacts & Calendar.
In the Start Menu, hit Run, enter %windir%, and hit Ok. The default Windows folder will be opened.
Copy and paste zarafa.ico into the folder. The icon can be found on the server in the following folder: /webaccess/client/layout/img/favicon.ico.

2.15.3. Linux

Make a new script file mailto.sh.

Put the following lines in the file:

#!/bin/bash

ADDRESS=`echo $1|cut -f 2 -d : -`

# Logs this to syslog... just helps to make sure it is working properly
logger "Opening Zarafa mail client, addressed to $ADDRESS"

firefox "http://<SERVER>/<USER>/webaccess/index.php?action=mailto&to=$ADDRESS"

Replace http://<SERVER>/<USER>/webaccess/ with base URL of the WebAccess.
Save the file (preferably in the home directory), then run chmod uog+rwx mailto.sh from the same directory.
Now type gnome-default-applications-properties on a console or go to System > Preferences > More Preferences > Preferred Applications.
Open “Mail reader” and set it to a custom action that looks like: /home/<USERNAME>/mailto.sh %s

2.15.4. Adding Zarafa WebAccess as mailto handler in Firefox

When clicking an URL of an email address (a mailto address) in Firefox it will try to open a mail client. Firefox has a list of possible mail clients to use, with the possibility to pick a default. To use the Zarafa WebAccess to handle mailto URLs in Firefox follow the these steps:

Type about:config in the address bar and press Enter. Ignore the warranty warning.
Put gecko.handlerservice in the filter box.
Double-click gecko.handlerServiceAllowRegisterFromDifferentHost. This will change its value from false to true.
Paste this code in the address bar while replacing https://URL/TO/YOUR/ZARAFA/WEBACCESS with the URL used to access the installation of the Zarafa WebAccess (usually the url used to get to the login screen of the WebAccess), then press Enter:
```
javascript:window.navigator.registerProtocolHandler("mailto","https://URL/TO/YOUR/ZARAFA/WEBACCESS?action=mailto&url=%s","Zarafa WebAccess")
```
Below the address bar a message asking if the Zarafa WebAccess should be added as an application to handle mailto links. Click the Add Application button.
Next time mailto: link is clicked, a screen will appear allowing the preferred mail client to be picked. Select the Zarafa WebAccess, and possibly check the box next to Remember my choice for mailto: links, then click OK.

From now on the Zarafa WebAccess will directly be used when clicking “mailto” links in Firefox. Please note that a user needs to be logged in (or make use of Single Sign On) for it to work smoothly.