PHPackages                             dsoares/blacklist - 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. [Mail & Notifications](/categories/mail)
4. /
5. dsoares/blacklist

ActiveRoundcube-plugin[Mail & Notifications](/categories/mail)

dsoares/blacklist
=================

Roundcube plugin to provide a generic access blacklist.

0.2.0(5y ago)572GPL-3.0+PHPPHP >=5.4

Since Mar 29Pushed 5y ago6 watchersCompare

[ Source](https://github.com/dsoares/roundcube-blacklist)[ Packagist](https://packagist.org/packages/dsoares/blacklist)[ Docs](https://github.com/dsoares/roundcube-blacklist)[ RSS](/packages/dsoares-blacklist/feed)WikiDiscussions master Synced today

READMEChangelog (4)Dependencies (2)Versions (6)Used By (0)

Roundcube plugin blacklist
==========================

[](#roundcube-plugin-blacklist)

Roundcube plugin to provide a generic access blacklist.

The plugin can be configured to deny access to specific usernames, IPs, networks in CIDR notation or countries. It is not meant to be configured by users, only by the Roundcube Webmail administrator via configuration file.

This is a useful plugin when users's passwords have been caught by spammers, but the administrators can not change the users's passwords (only the user may change it's own password).

Stable versions of this plugin are available from the [Roundcube plugin repository](https://plugins.roundcube.net/packages/dsoares/blacklist) or the [releases section](https://github.com/dsoares/roundcube-blacklist/releases) of the GitHub repository.

Requirements
------------

[](#requirements)

- [Roundcube plugin geolocation](https://plugins.roundcube.net/packages/dsoares/geolocation) if you configure to deny access by country.

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

[](#installation)

#### With composer

[](#with-composer)

1. Go to your Roundcube root directory.
2. Run `$ composer require dsoares/blacklist`.
3. Copy `config.inc.php.dist` to `config.inc.php` and modify as necessary.

#### Manual Installation

[](#manual-installation)

Place this directory (named blacklist) under your Rouncdube `plugins/`and enable blacklist plugin within the main Roundcube configuration file.

Copy `config.inc.php.dist` to `config.inc.php` and modify as necessary.

Please note that if you want to block access by country in the configuration file, this plugin requires the [Roundcube plugin geolocation](https://plugins.roundcube.net/packages/dsoares/geolocation)to be enabled and properly working. Check the [geolocation](https://plugins.roundcube.net/packages/dsoares/geolocation) plugin instructions for more information.

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

[](#configuration)

- **$config\['blacklist\_usernames'\]** - `array` of usernames to deny access.
- **$config\['blacklist\_ips'\]** - `array` of IPs and networks in CIDR notation to deny access.
- **$config\['blacklist\_countries'\]** - `array` of countries to deny access.
- **$config\['blacklist\_log'\]** - `boolean`, if the plugin should log denied requests.

License
-------

[](#license)

This plugin is released under the [GNU General Public License Version 3+](https://www.gnu.org/licenses/gpl.html).

Contact
-------

[](#contact)

Comments and suggestions are welcome!

Email: [Diana Soares](mailto:diana.soares@gmail.com)

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~426 days

Total

5

Last Release

2042d ago

PHP version history (2 changes)0.1.0PHP >=5.2.1

0.2.0PHP >=5.4

### Community

Maintainers

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

---

Top Contributors

[![dsoares](https://avatars.githubusercontent.com/u/673736?v=4)](https://github.com/dsoares "dsoares (13 commits)")

---

Tags

blacklistpluginroundcubesecuritymailroundcube

### Embed Badge

![Health badge](/badges/dsoares-blacklist/health.svg)

```
[![Health](https://phpackages.com/badges/dsoares-blacklist/health.svg)](https://phpackages.com/packages/dsoares-blacklist)
```

###  Alternatives

[zbateson/mail-mime-parser

MIME email message parser

54753.3M91](/packages/zbateson-mail-mime-parser)[toteph42/identity_switch

This plugin allows users to switch between different identities (and check for new mails) in a single Roundcube session.

221.5k](/packages/toteph42-identity-switch)[zbateson/stream-decorators

PHP psr7 stream decorators for mime message part streams

4752.6M9](/packages/zbateson-stream-decorators)[dsoares/rcguard

Roundcube plugin that enforces reCAPTCHA for users that have too many failed logins

254.0k](/packages/dsoares-rcguard)[opcodesio/mail-parser

Parse emails without the mailparse extension

228.8M11](/packages/opcodesio-mail-parser)[kitist/html5_notifier

Desktop Notifications for Roundcube

7911.8k](/packages/kitist-html5-notifier)

PHPackages © 2026

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