Search by

toteph42 / identity_switch

toteph42

This plugin allows users to switch between different identities (and check for new mails) in a single Roundcube session.

Package info

github.com/toteph42/identity_switch

Type:roundcube-plugin

pkg:composer/toteph42/identity_switch

Statistics

Installs: 1 828

Dependents: 0

Suggesters: 0

Stars: 24

Open Issues: 0

3.0.19 2026-11-12 15:28 UTC

README

This plugin allows users to switch between different identities in a single RoundCube session like this:

Plugin settings

If you receive new mails, the number of new mails will be shown in identity selection menue.

Where to start

  • In settings interface create new identity.
  • Be sure to fill in the Name of identity.
  • After you have created at least one identity you will see combobox instead of plain text field where your account name was displayed before. There you can switch between the identifities.

Settings

From now on all user preferences and connection settings will belong to the active identity. To indicate for which dentity you're changing preferences, you will see the identity in the header line in format [ Identity: {Active Identity} ] in the Preference menue.

There are some new setting available in Preference -> Mailbox view.

Plugin settings

  • Check all folders... - Select this option, if you want all folders to be check for new mails.
  • Display browser notification... - Select this option, if you want to get a changed icon for this site. Please be aware, that the icon will change only one time, even if there a new mails for multiple identities available (until next new-mail check-cycle is started).
  • Display desktop notification... - Select this option, if you want to get a desktop notification about how many new mails were available. Please be aware, you need to allow your mail server site in your browser configuration to send notifications to your desktop.
  • Close desktop notification - Specify how many seconds should be visible before it is automatically been closed.
  • Play sound... - Select this option, if you want a sound notification. Please be aware, that only sound will be played one time only, even if there are new mails for multiple identities available (until next new-mail check cycle is started). If you hear no sound playing, please check your browser settings, if auto-play of sound files is enabled.

Configuration

  • All plugin settings were defined in default.inc.php. For a descption about all supported RoundCube connection parameters please refer to [base dir]/config/default.inc.php.
  • If you want to apply your own configurtion changes, please copy file default.inc.php to config.inc.php and change the preferences in this file.
  • All preferences will override RoundCube connection settings for active identity.
  • Depending on configuration variable cfg_typ you'll see different option to edit when selecting a identity to edit. Either it is completely disabled or you may add IMAP and SMTP informations or you'll see a text box, allowing you to edit all connection paramaters in detail.
  • Only cfg_typ = 2: All passwords were show as ●●●●●●●●. If you change your password by entering visible text, it will be encrypted immediately after you hit the SAVE button.
  • If you want to change sound, icon or desktop icon, please change alert.mp3, alert.ico and alert.gif in directory assets.

Locking configuration

You may use the dont_override configuration option in your RoundCube configuration file config/config.inc.php to lock settings from being overriden. Plugin connection settings cannot be locked.

Performance

New mail checking is performed in background asynchronously. This has the effect that the new mail counter is not always updated immediately after login - it may take some time before this has been performed. It heavily depends on the number of identities you're using.

If you've select Check all folders, this has a huge impact on the time new-mail checking need to collect information. If you have hundreds of folders in your mail box, each of the boxes will be checked for new mails.

Depending on the workload on your host, it migth happen, that the menue isn't opened as quick as expected. This depend on how RoundCube is able to handle the synchroneous Ajax requests.

Version compatibility

Versions 3.x - for RoundCube v1.6.x and 1.7.x requires PHP version >= 8.0.0.

Limitations

This plugin only supports Elastic skin. If you wan't to get another skin to be supoorted, then please contact me. I can add support for other skins if you pay for it. Or you modify plugin according to your needs and send me your changes.

License

This plugin is released under the [GNU General Public License v3.0].

Migration

If you want to migrate plugin data from version 2.x, there is a small PHP script available. This can be called by entering[URL]/plugin/identity_switch/idnetity_switch_migrate.php in you favorite browser. You should then see at least two messages:

Trying to delete table "identity_switch"...

0 identities successfully migrated.

Debugging

If you encounter problems with plugin, take a look at the debug options available in default.inc.php.

If you encounter connection problems, it is a good idea to enable RoundCube available debugging options.

Donation

If you like this software and you want support my work, feel free to send me a donation:

Donate with PayPal

[List of changes]