From 546e9ba882309ca8a59a4d7d49d9dc09ce201fae Mon Sep 17 00:00:00 2001 From: Laurent Dinclaux Date: Tue, 10 Feb 2026 10:56:51 +1100 Subject: [PATCH] Add migration guide for users of the original plugin --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.md b/README.md index f4b7c76..5028420 100644 --- a/README.md +++ b/README.md @@ -52,6 +52,26 @@ Optionally copy `plugins/ident_switch/config.inc.php.dist` to `plugins/ident_swi * **Server host name** - host name for imap server. If left blank 'localhost' will be used. * **Port** - port on server to connect to. If left blank 587 will be used. +### Migrating from the original plugin ### + +If you are upgrading from the original `boressoft/ident_switch` or another fork: + +1. Replace the plugin files in `plugins/ident_switch/`. +2. Run the database migration to update the schema: +```sh +bin/updatedb.sh --package=ident_switch --dir=plugins/ident_switch/SQL +``` +3. If you use `config.inc.php`, update it to the new format. The `'host'` key has been replaced by separate `'imap_host'` and `'smtp_host'` keys (the old `'host'` key still works as fallback): +```php +'domain.tld' => [ + 'imap_host' => 'ssl://mail.domain.tld:993', + 'smtp_host' => 'tls://mail.domain.tld:587', + 'user' => 'email', + 'readonly' => true, +], +``` +4. If installed via Composer, update `composer.json` to use `gecka/roundcube-ident_switch` instead of `boressoft/ident_switch`. + ### Version compatibility ### * Versions 1.X (not supported any more) - for Roundcube v1.1 * Versions 2.X (not supported any more) - for Roundcube v1.2