Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Clevercube - Various plug-ins for the Roundcube webmail

  1. Description

  2. Requirements

  3. Installation

  4. Configuration

  5. Plug-ins

  6. External database

  7. External authentication

  8. Autoresponder manager

  9. License

  10. Support

  11. Authors

  12. Description

Clevercube provides addons to extend the default behavior of Roundcube webmail.

  1. Requirements

  1. Installation

  • Download the latest release from and extract the archive to the chosen destination directory.

    Development files can be browsed via web browser or can be optained from a git repository

    Note: You can also get the sources using the GIT and cloning the repository.

  • Copy directory clevercube and all directories starting with cc_ to Roundcube plugins directory.

  1. Configuration

To enable all Clevercube plug-ins add clevercube to the $rcmail_config['plugins'] array in config/ It's recommended to define it as the first plugin.

$rcmail_config['plugins'] = array('clevercube');

Configuration files for each plug-in are located in a directory called config/ relative to plug-in's directory.

Copy to and set the options as described within the file.

Each plug-in can be disabled separately from clevercube plug-in config file.

  1. Plug-ins

5.1. External database (cc_external_database)

This plug-in let's to use external databases in other plug-ins, which support them.

To get the database handler, use the get_external_db(profile) function in Your plug-in or configuration file. Different profiles can be defined in the

$rcmail_config['my_plugin_db'] = get_external_db('users');

5.2. External authentication (cc_external_auth)

A plug-in that adds a possibility to log in via external login form and redirects logout and login error pages to specified URL as GET requests.

This is an example PHP external login page. Replace form action URL /roundcubemail/index.php with URL of Your Roundcube installation.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<html xmlns="">
    <title>Webmail login</title>
    <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
    <meta name="description" content="Webmail login" />
    <meta name="keywords" content="Webmail login" />
    $message = urldecode(trim($_GET['message']));
    echo '    <div style="color:#f00;display:none">'.$message.'</div>';
    <form name="webmail" action="/roundcubemail/index.php" method="post">
        <input name="_action" value="login" type="hidden" />
        User <input name="_user" type="text" /><br />
        Pass <input name="_pass" type="password" /><br />
        <input type="hidden" name="_task" value="login">
        <input type="hidden" name="_action" value="login" />
        <input type="submit" />

Note: If debug level is set to display errors and errors are being displayed before the redirection process then redirection is not performed. Make sure that PHP display_errors is off and $rcmail_config['debug_level'] is set to 1.

5.3. Autoresponder manager (cc_ar_manager)

This plug-in provides a framework for an autoresponder managing feature. Plug-in user could write the correct API for the autoresponder solution which he or she uses in the servers. This plug-in is only a framework, because when using the Postfix one could define custom autoresponder solution with custom database structure so it would be impossible to make an universal solution, but this framework will give the common possibilities (enabling/disabling, defining the response message and also setting the response date period).

Please see the api/example.php for the example with comments.

  1. License

This software is licensed as described in the file, which You should have received as part of this distribution. The terms are also available at

  1. Support

Issue tracker can be found at

  1. Authors