ident_switch

ident_switch plugin for Roundcube

This plugin allows users to switch between different accounts (including remote) in single Roundcube session like this:

Inspired by identities_imap plugin that is no longer supported.

Installation

With Composer (recommended)

composer require gecka/roundcube-ident_switch
bin/updatedb.sh --package=ident_switch --dir=plugins/ident_switch/SQL

The plugin is automatically registered. Enable it by adding 'ident_switch' to $config['plugins'] in your Roundcube config/config.inc.php.

Manual

1. Copy or symlink the plugin to plugins/ident_switch in your Roundcube installation.
2. Add 'ident_switch' to the $config['plugins'] array in your Roundcube config/config.inc.php.
3. Initialize the database schema:

bin/updatedb.sh --package=ident_switch --dir=plugins/ident_switch/SQL

Configuration

Optionally copy plugins/ident_switch/config.inc.php.dist to plugins/ident_switch/config.inc.php and edit it to preconfigure mail settings per domain.

Where to start

• In settings interface create new identity.
• For all identities except default you will see new section of settings - "Plugin ident_switch" (see screenshot below). Enter data required to connect to remote server. Don't forget to check Enabled check box.
• After you have created at least one identity with active plugin you will see combobox in the top right corner instead of plain text field with account name. It will allows you to switch to another account.

Settings

• Enabled - enables plugin (i.e. account switcing) for this identity.
• Label - text that will be displayed in drop down list for this identity. If left blank email will be used.
• IMAP
  • 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 143 will be used.
  • Secure connection - enabled secure connection (TLS) for both IMAP and SMTP.
  • Username - login used for IMAP and SMTP servers.
  • Password - password used for IMAP and SMTP servers. It's stored encrypted in database.
• SMTP
  • 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:

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):

'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
• Versions 3.X (not supported any more) - for Roundcube v1.3
• Versions 4.x - for Roundcube v1.3, 1.4 and 1.5.
• Versions 5.x - for Roundcube v1.6+ (PHP 8.1+)

This is a fork of the original plugin by Boris Gulay, maintained at Gecka-apps/ident_switch.

Contributors

• Boris Gulay - Original developer (2016-2022)
• Christian Landvogt - Special folders support (2019)
• Gergely Papp - Bug fixes (2021)
• Mickael - SMTP compatibility fix (2022)
• Laurent Dinclaux - Gecka - Current maintainer (2026)