Download the PHP package gecka/ident-switch without Composer
On this page you can find all versions of the php package gecka/ident-switch. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package ident-switch
Ultimate Identity Switcher for Roundcube
Switch between multiple IMAP accounts within a single Roundcube session.
About
ident_switch is a Roundcube plugin that turns identities into full account shortcuts. Configure each identity with its own IMAP, SMTP and Sieve server, then switch between accounts with a single click from the toolbar dropdown. Aliases, notifications, and domain preconfig are all built in.
Originally created by Boris Gulay. This fork is a major rewrite by Gecka — modernized for PHP 8.2+, restructured codebase, and packed with new features: alias identities, Sieve support, background mail notifications, domain preconfig, connection testing, and per-protocol security.
Features
Multi-Account Switching
- One-click account switching from a toolbar dropdown
- Each identity can be linked to a separate IMAP/SMTP server with its own credentials
- Automatic special folder mapping (Sent, Drafts, Junk, Trash) per account
- Encrypted password storage in database
Alias Identities
- Link identities as aliases of any configured account (not just the primary)
- Aliases share the parent account's IMAP inbox, SMTP and Sieve configuration
- Compose "From" dropdown automatically filtered to show only the active account and its aliases
Sieve (ManageSieve) Support
- Per-account Sieve server configuration with independent host, port and credentials
- Three authentication modes: same as IMAP, none, or custom credentials
- Sieve section only appears when the
managesieveplugin is active
New Mail Notifications
- Background mail checking across all secondary accounts
- Unread count badge in the account switcher dropdown
- Per-account notification settings: favicon, sound, desktop notifications
- Optional round-robin mode to reduce IMAP connections with many accounts
- Integrates with Roundcube's
newmail_notifierplugin
Domain Preconfig
- Pre-fill server settings based on the identity's email domain
- Wildcard domain support (
*) for catch-all defaults - Lock preconfigured fields as read-only to prevent user changes
- Restrict account creation to preconfigured domains only (
preconfig_onlymode)
Security
- Per-protocol security selection: None, STARTTLS, or SSL/TLS (IMAP, SMTP, Sieve independently)
- Connection testing on save (IMAP, SMTP, Sieve) to catch misconfigurations early
- Passwords encrypted using Roundcube's built-in encryption
- Warning displayed when selecting unencrypted connections
Requirements
- PHP 8.2+
- Roundcube 1.6+
- MySQL, PostgreSQL, or SQLite
Installation
With Composer (recommended)
Navigate to your Roundcube installation directory and run:
The roundcube/plugin-installer will automatically place the plugin in the correct plugins/ directory, initialize the database schema, and offer to enable it.
Don't have Composer? See getcomposer.org for installation instructions.
Running as root on a VPS? Roundcube files are typically owned by
www-data. Run Composer as the web server user to avoid permission issues:
Manual
-
Place this plugin folder into the plugins directory of Roundcube:
-
Add
ident_switchto$config['plugins']in your Roundcube config: - Initialize the database schema:
Configuration
Copy the sample configuration file and edit it to match your environment:
Domain Preconfig
Pre-fill server settings per email domain so users don't have to enter them manually:
Options
| Setting | Default | Description |
|---|---|---|
ident_switch.check_mail |
true |
Enable background mail checking across secondary accounts |
ident_switch.round_robin |
false |
Check one account per refresh cycle instead of all at once |
ident_switch.hide_notifier_warning |
false |
Hide the warning when newmail_notifier plugin is not active |
ident_switch.preconfig_only |
false |
Restrict account creation to preconfigured domains only |
ident_switch.debug |
false |
Log SMTP/Sieve routing and alias resolution to logs/ident_switch.log |
Usage
- Create a new identity in Settings > Identities
- Choose the account mode:
- Primary account — default identity, no server config needed
- Separate account — configure IMAP, SMTP, and optionally Sieve servers
- Alias of [account] — link to an existing account's servers
- For separate accounts, fill in server details (or let preconfig handle it)
- The account switcher dropdown appears in the toolbar once at least one separate account is configured
Updating
Database migrations are applied automatically by the Roundcube plugin installer.
Migrating from the Original Plugin
If you are upgrading from boressoft/ident_switch, toteph42/identity_switch, or another fork:
Important: This version (5.x) requires a v4.x database schema as its starting point. If you are running v1.x–v3.x, you must first upgrade to v4.x (
boressoft/ident_switch) before migrating to this fork. This applies to all supported databases (MySQL, PostgreSQL, SQLite).
With Composer
- Replace the old package in
composer.jsonwithgecka/ident-switchand runcomposer update - Database migrations are applied automatically
Manual
- Replace the plugin files in
plugins/ident_switch/ - Run the database migration:
Configuration
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 (old 'host' key still works as fallback).
Localization
Available in 7 languages: English, French, German, Italian, Dutch, Russian, Slovenian.
Version Compatibility
| Version | Roundcube | PHP |
|---|---|---|
| 5.x | 1.6+ | 8.2+ |
| 4.x | 1.3 — 1.5 | 7.x — 8.1 |
| 1.x — 3.x | 1.1 — 1.3 | discontinued |
License
This plugin is released under the GNU Affero General Public License Version 3.
Original code by Boris Gulay licensed under GPL-3.0+. New contributions licensed under AGPL-3.0+.
Authors
- Boris Gulay — Original developer (2016–2022)
- Christian Landvogt — Special folders support
- Gergely Papp — Bug fixes
- Laurent Dinclaux — Current maintainer (Gecka)
Built with 🥥 and ☕ by Gecka — Kanaky-New Caledonia 🇳🇨
