gianlucagiacometti/roundcube-toolbox

Set of tools for Roundcube webmail

1.6.0 2023-01-01 16:52 UTC

This package is auto-updated.

Last update: 2024-04-13 00:23:34 UTC


README

This plugin is a set of tools for Roundcube Webmail
Some tools are designed to work with PostfixAdmin / Postfix with sql backend

ATTENTION

This plugin works with RC 1.6.

Release 1.6.0 of the plugin works with 1.6 of Roundcube Webmail

Master branch works with the Git version of Roundcube Webmail

Available tools

  • aliases [tool to manage aliases in postfixadmin]
  • forward [tool to manage forward addresses in postfixadmin]
  • vacation [tool to manage postfixadmin vacation]
  • purge [tool to periodically purge Trash and Junk folders]
  • preview [tool to disable message preview]
  • customise [tool to customise Blank Page and CSS per domain]
  • attachments [tool to replace large attachments with a link in outgoing messages]

Requirements

License

This plugin is released under the GNU General Public License Version 3+ except skins, which are subject to the Creative Commons Attribution-ShareAlike License.

Install

  • Place this plugin folder into plugins directory of Roundcube
  • Change the folder name to 'toolbox'
  • Add 'toolbox' to $config['plugins'] in your Roundcube config file

NB: When downloading the plugin from GitHub you will need to create a directory called toolbox and place the files in there, ignoring the root directory in the downloaded archive.

Update database using the appropriate file in the SQL folder.

Customise tool needs a folder called 'tmp' writeable by the web browser.
Attachments tool needs a folder called attachments writeable by the web browser.
The file /bin/initplugin.sh can do the job for you.

Config

The default config file is plugins/toolbox/config.inc.php.dist
Copy 'config.inc.php.dist' to 'config.inc.php'
Edit the plugin configuration file 'config.inc.php' and choose the appropriate options

$rcmail_config['toolbox_dsn']
Sets the connection to the data source
Examples:

$rcmail_config['toolbox_dsn'] = 'pgsql://username:password@localhost/database';
$rcmail_config['toolbox_dsn'] = 'mysql://username:password@host/database';

$config['toolbox_sql_table_name']
Sets the name of the sql table
Default value:

$config['toolbox_sql_table_name'] = 'toolbox';

$config['toolbox_sql_username_field']
Sets the name of the username field in the toolbox sql table
Default value:

$config['toolbox_sql_username_field'] = 'username';