PHPackages                             roundcube/plugin-installer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. roundcube/plugin-installer

ActiveComposer-plugin[Utility & Helpers](/categories/utility)

roundcube/plugin-installer
==========================

A composer-installer for Roundcube plugins and skins.

0.3.11(7mo ago)34399.7k↓17.8%18[1 issues](https://github.com/roundcube/plugin-installer/issues)[1 PRs](https://github.com/roundcube/plugin-installer/pulls)20GPL-3.0-or-laterPHPPHP >=7.3 <8.6CI failing

Since Oct 27Pushed 7mo ago9 watchersCompare

[ Source](https://github.com/roundcube/plugin-installer)[ Packagist](https://packagist.org/packages/roundcube/plugin-installer)[ RSS](/packages/roundcube-plugin-installer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (9)Versions (25)Used By (20)

Plugin Installer for Roundcube
==============================

[](#plugin-installer-for-roundcube)

This installer ensures that plugins and skins end up in the correct directory:

- Plugins - `/plugins/plugin-name`
- Skins - `/skins/skin-name`

Minimum setup
-------------

[](#minimum-setup)

- create a `composer.json` file in your plugin's repository
- add the following contents

### sample composer.json for plugins

[](#sample-composerjson-for-plugins)

```
{
    "name": "/",
    "type": "roundcube-plugin",
    "license": "GPL-3.0-or-later",
    "require": {
        "roundcube/plugin-installer": ">=0.3.0"
    }
}

```

### sample composer.json for skins

[](#sample-composerjson-for-skins)

```
{
    "name": "/",
    "type": "roundcube-skin",
    "license": "GPL-3.0-or-later",
    "require": {
        "roundcube/plugin-installer": ">=0.3.0"
    }
}

```

Roundcube specific composer.json params
---------------------------------------

[](#roundcube-specific-composerjson-params)

For both plugins and skins you can, optionally, add the following section to your `composer.json` file. All properties are optional and provided below with example values. `persistent-files` defines a list of files which should be maintained across updates. By default only `config.inc.php` is maintained. The array should contain paths relative to the root of your plugin.

```
"extra": {
    "roundcube": {
        "min-version": "1.4.0",
        "sql-dir": "./SQL",
        "post-install-script": "./bin/install.sh",
        "post-update-script": "./bin/update.sh",
        "persistent-files": ["config.inc.php", "skins/elastic/_custom.less"]
    }
}

```

Configuration
-------------

[](#configuration)

This installer will ask if you want to enable each plugin or skin as it is installed. To always enable all plugins or skins add `enable-plugin`/`enable-skin` to the `config` section in the `composer.json` in the root of your Roundcube directory. When uninstalling packages Composer will not remove the folder. To remove the folder set `uninstall-remove-folder` in your config.

```
"config": {
    "roundcube": {
        "enable-plugin": true,
        "enable-skin": true,
        "uninstall-remove-folder": true
    }
}

```

Repository
----------

[](#repository)

Submit your plugin or skin to [Packagist](https://packagist.org/).

Installation
------------

[](#installation)

- clone Roundcube
- `cp composer.json-dist composer.json`
- add your plugin in the `require` section of composer.json
- `composer.phar install`

Read the whole story at [plugins.roundcube.net](http://plugins.roundcube.net/#/about/).

###  Health Score

60

—

FairBetter than 99% of packages

Maintenance63

Regular maintenance activity

Popularity48

Moderate usage in the ecosystem

Community41

Growing community involvement

Maturity80

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~205 days

Recently: every ~126 days

Total

24

Last Release

228d ago

PHP version history (5 changes)0.1.0PHP >=5.3.0

0.3.5PHP >=7.3 <8.4

0.3.8PHP >=7.3 <=8.4

0.3.9PHP >=7.3 <8.5

0.3.11PHP >=7.3 <8.6

### Community

Maintainers

![](https://www.gravatar.com/avatar/ca375ba7fba191a133e70100629611d9f4277281366188c7798da7ae39d92218?d=identicon)[roundcubedev](/maintainers/roundcubedev)

---

Top Contributors

[![alecpl](https://avatars.githubusercontent.com/u/546788?v=4)](https://github.com/alecpl "alecpl (23 commits)")[![mvorisek](https://avatars.githubusercontent.com/u/2228672?v=4)](https://github.com/mvorisek "mvorisek (22 commits)")[![thomascube](https://avatars.githubusercontent.com/u/1577511?v=4)](https://github.com/thomascube "thomascube (17 commits)")[![johndoh](https://avatars.githubusercontent.com/u/88682?v=4)](https://github.com/johndoh "johndoh (10 commits)")[![till](https://avatars.githubusercontent.com/u/27003?v=4)](https://github.com/till "till (4 commits)")[![Takika](https://avatars.githubusercontent.com/u/1705821?v=4)](https://github.com/Takika "Takika (2 commits)")[![mazzanet](https://avatars.githubusercontent.com/u/8002516?v=4)](https://github.com/mazzanet "mazzanet (1 commits)")[![jeromelebleu](https://avatars.githubusercontent.com/u/3597194?v=4)](https://github.com/jeromelebleu "jeromelebleu (1 commits)")[![dsoares](https://avatars.githubusercontent.com/u/673736?v=4)](https://github.com/dsoares "dsoares (1 commits)")[![andreashaerter](https://avatars.githubusercontent.com/u/228611?v=4)](https://github.com/andreashaerter "andreashaerter (1 commits)")

###  Code Quality

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/roundcube-plugin-installer/health.svg)

```
[![Health](https://phpackages.com/badges/roundcube-plugin-installer/health.svg)](https://phpackages.com/packages/roundcube-plugin-installer)
```

###  Alternatives

[vaimo/composer-patches

Applies a patch from a local or remote file to any package that is part of a given composer project. Patches can be defined both on project and on package level. Optional support for patch versioning, sequencing, custom patch applier configuration and patch command for testing/troubleshooting added patches.

2994.3M16](/packages/vaimo-composer-patches)[mglaman/composer-drupal-lenient

1317.4M15](/packages/mglaman-composer-drupal-lenient)[drupal/core-composer-scaffold

A flexible Composer project scaffold builder.

5341.9M446](/packages/drupal-core-composer-scaffold)[drupal/core-project-message

Adds a message after Composer installation.

2122.6M172](/packages/drupal-core-project-message)[olvlvl/composer-attribute-collector

A convenient and near zero-cost way to retrieve targets of PHP 8 attributes

184108.8k8](/packages/olvlvl-composer-attribute-collector)[lullabot/drainpipe

An automated build tool to allow projects to have a set standardized operations scripts.

41716.4k2](/packages/lullabot-drainpipe)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)