Getting Started
The plugin repository for Roundcube is based on Composer to manage, install and update the plugins for your Roundcube installation. The following two steps are necessary to connect your local Roundcube installation to the plugin repository:
1. Install Composer
Run this in your command line:
cd <roundcube-project-root>
curl -s https://getcomposer.org/installer | php
Or download composer.phar into your Roundcube root directory.
2. Configure composer.json
Copy the template composer.json-dist
to composer.json
in your Roundcube root directory.
3. Installing plugins
Browse through our repository and find the plugins you want to install.
Then edit your local composer.json file and add the "vendor/plugin"
names to the "require"
section of the JSON structure. Don't forget to specify the version constraint:
"require" : {
...,
"roundcube/rcsample": ">=0.2.0"
}
After every change to composer.json run
php composer.phar install
to download and install all dependencies.
The plugins are installed to the plugins/
directory and when running the install command you'll be asked whether to activate the plugins right away. For any later activation or deactivation of a plugin, you can add/remove the plugin name to/from the $config['plugins']
option in your local Roundcube config file config/config.inc.php.