2.1   API Changes

Added the 'newEmailFilter' API link. Takes one argument: 'email', the e-mail address to pre-populate into a new rule.

2.2   Backend Configuration (backends.php)

The Sieve driver now uses the 'enotify' extension by default. If using an old version of Sieve that only supports the deprecated 'notify' setting, set 'notify' to true in the sieve script parameters (see backends.php).

The Sieve driver now uses 'imap4flags' by default to set flags. If using an old version of Sieve that only supports the deprecated 'imapflags' setting, set 'imapflags' to true in the sieve script parameters (see backends.php).

2.3   Configuration Options (conf.php)

The following options have been removed (see Permissions section for replacement functionality):

$conf['storage']['maxblacklist']
$conf['storage']['maxwhitelist']

2.4   Permissions

Ingo permissions are now applied per backend. To upgrade existing permissions, an admin needs to run the following script:

bin/ingo-admin-upgrade --task=backend_perms

The following permissions have been added:

max_blacklist
max_forward
max_whitelist

The following permissions have been removed:

allow_rules (replacement: set max_rules permission to 0)

3.1   Backend Configuration (backends.php)

The 'script' and 'transport' settings of the backend configuration have been changed from strings to arrays, to allow different backends for different filter rules.

3.2   API Changes

The applyFilters() no longer returns a value.

4.1   Backend Configuration (backends.php)

The 'hordeauth' parameter and the 'password' and 'username' parameters have been removed. By default, the transport backend will use Horde authentication credentials to access. To set a different username and/or password, you should use the 'transport_auth' hook.

5.1   Configuration Options (conf.php)

The following configuration options have been removed:

usefolderapi

5.2   Sieve Backend

The port number for the timesieved daemon has been changed to the official Sieve port 4190 in the default configuration. If your timesieved daemon is still running on the former default port 2000, or any other port than 4190, you need to create a config/backends.local.php file with the following content:

<?php
$backends['sieve']['params']['port'] = 2000;
$backends['sivtest']['params']['port'] = 2000;

8.1   SQL Backend

An SQL table has been added than can optionally be used as a storage backend for the filter rules. Using this backend no longer limits the number and size of rules.

Execute the provided SQL script to add the table to your database, e.g.:

mysql --user=root --password=<MySQL-root-password> <db name> < scripts/sql/ingo.sql

You also have to execute the provided PHP script to migrate the existing rules from the preferences backend to the new database table:

ingo-convert-prefs-to-sql < filename

filename is a file that contains a list of users, one username per line. The username should be the same as how the preferences are stored in the preferences backend (e.g. usernames may have to be in the form user@example.com). You can create such a list with the following MySQL command:

mysql --user=root --password=<MySQL-root-password> --skip-column-names --batch --execute='SELECT DISTINCT pref_uid FROM horde_prefs' <db name>

8.2   New Beta SQL Share Driver Support

A new beta-level SQL Horde_Share driver has been added in Horde 3.2. This driver offers significant performance improvements over the existing Datatree driver, but it has not received the same level of testing, thus the beta designation. In order to make use of this driver, you must be using Horde 3.2-RC3 or later. To migrate your existing share data, run ingo-convert-datatree-shares-to-sql. Be sure to read the entry above and create the new SQL tables before running the migration script.

9.1   Backends parameter changes - procmail driver

In config/backends.php, the procmailrc parameter in the procmail entry has been deprecated. It has been replaced by the filename parameter.