Download the PHP package toteph42/identity_switch without Composer
On this page you can find all versions of the php package toteph42/identity_switch. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download toteph42/identity_switch
More information about toteph42/identity_switch
Files in toteph42/identity_switch
Package identity_switch
Short Description This plugin allows users to switch between different accounts (and check for new mails) in a single Roundcube session.
License GPL-3.0+
Homepage https://github.com/totep42/identity_switch
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 identity_switch
identity switch plugin for Roundcube
This plugin is based on the ident_switch plugin. It is completly rewritten and additional features have been added.
This plugin allows users to switch between different accounts in a single Roundcube session like this:
Where to start
- In settings interface create new identity.
- For all identities except default you will see new section of settings - "Data of your identity" (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 switching) for this identity.
- Label - Text that will be displayed in drop down list for this identity.
- IMAP
- Server host name - Host name for imap server. If left blank 'localhost' will be used.
- Encryption - Connection security (None, SSL or TLS).
- Port - Port on server to connect to. If left blank 143 will be used.
- Username - Login used for IMAP and SMTP servers.
- Password - Password used for IMAP and SMTP servers. It's stored encrypted in database.
- Delimiter - IMAP folder delimiter.
- SMTP
- Server host name - Host name for imap server. If left blank 'localhost' will be used.
- Encryption - Connection security (None, SSL or TLS).
- Port - Port on server to connect to. If left blank 25 will be used.
Settings for active identity
If you've selected an identity (or use the default identity), you may change settings for new-mail check cycle in Settings -> Preference -> User Interface.
If you've selected an identity (or use the default identity), you may change settings for notification settings in Settings -> Preference -> Mailbox view.
Additional 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.
- Refresh... - Specify the new-mail check cycle in minutes.
If you receive new mails, the number of new mails will be shown in identity selection menue.
Configuration
There is a file config.inc.php in the plugin directory available. This file can be used to specify some configuration settings.
If you want to change sound, icon or desktop icon, please checkout alert.mp3, alert.ico and alert.gif in sub-directory assets.
Locking configuration
You may use the dont_override configuration option in your config/config.inc.php file to lock some options from being overriden. This plugins supports the following options to be protected:
draft_mbox,sent_mbox,junk_mbox,trash_mbox- User cannot override preconfigured special folder name.check_all_folders- User cannot override preconfigured flag to check all folders.newmail_notifier_basic,newmail_notifier_desktop,newmail_notifier_sound- User cannot override preconfigured notification setting.
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 check for new mails.
Please don't forget to set Special Folders in Settings -> Preferences. All folders specified there (and their sub-folders) will be excluded from new-mail checking.
Version compatibility
- Versions 1.x - for Roundcube v1.6. Requires PHP version >= 8.0.0.
Limitations
This plugin only supports Classic, Elatic, Larry and Hivemail skin. If you wan't to get another skin to be supoorted, then please contact me.
Migration from ident_switch plugin
If you've installed the ident_switch plugin, there is a migration file available in SQL subdirectory which copies the content of the old table to the new table and deletes the ident_switch table. To make this happen, you should first install this plugin (during installation a table identity_switch will automatically be created) and then you should appy SQL/migrate.sql.
Upgrade
If you want to upgrade to this plugin, please be aware, the name of the data base table has changed. In subdirectoy SQL ther
are scrpst avaibale to ugrade your installation. These scriüps must called manually (look for 20241122.sql). This script must be called after installation of identity_switch plugin, but before removing identy_switch plugin.
License
This plugin is released under the GNU General Public License v3.0.
Donation
If you like this software and you want support my work, feel free to send me a donation:
[List of changes]
