Title: Comment Blacklist Manager
Author: Andrew Norcross
Published: <strong>ମଇ 21, 2014</strong>
Last modified: ମଇ 25, 2026

---

Search plugins

![](https://ps.w.org/comment-blacklist-manager/assets/banner-772x250.jpg?rev=1071762)

![](https://ps.w.org/comment-blacklist-manager/assets/icon-256x256.png?rev=2265891)

# Comment Blacklist Manager

 By [Andrew Norcross](https://profiles.wordpress.org/norcross/)

[Download](https://downloads.wordpress.org/plugin/comment-blacklist-manager.1.0.1.zip)

 * [Details](https://ory.wordpress.org/plugins/comment-blacklist-manager/#description)
 * [Reviews](https://ory.wordpress.org/plugins/comment-blacklist-manager/#reviews)
 *  [Installation](https://ory.wordpress.org/plugins/comment-blacklist-manager/#installation)
 * [Development](https://ory.wordpress.org/plugins/comment-blacklist-manager/#developers)

 [Support](https://wordpress.org/support/plugin/comment-blacklist-manager/)

## Description

Comment Blacklist Manager retrieves a list of terms from a remote source and updates
the `disallowed_keys` setting in WordPress. The plugin will automatically fetch 
a list of terms on a regular schedule and update the contents of the “Disallowed
Comment Keys” field. Terms added manually via the “Local Blacklist” field will be
retained during the scheduled updates. Terms added manually to the “Excluded Terms”
field will be removed from the list.

The default list of terms is fetched from a [GitHub](https://github.com/splorp/wordpress-comment-blacklist/)
repository maintained by [Grant Hutchinson](https://splorp.com/).

## Screenshots

 * [[
 * The “Discussion Settings” screen showing the various blacklist fields

## Installation

**To install the plugin using the WordPress dashboard:**

 1. Go to the “Plugins > Add New” page
 2. Search for “Comment Blacklist Manager”
 3. Click the “Install Now” button
 4. Activate the plugin on the “Plugins” page
 5. (Optional) Add terms to the “Local Blacklist” field in “Settings > Discussion”
 6. (Optional) Add terms to the “Excluded Terms” field in “Settings > Discussion”

**To install the plugin manually:**

 1. Download the plugin and decompress the archive
 2. Upload the `comment-blacklist-manager` folder to the `/wp-content/plugins/` directory
    on the server
 3. Activate the plugin on the “Plugins” page
 4. (Optional) Add terms to the “Local Blacklist” field in “Settings > Discussion”
 5. (Optional) Add terms to the “Excluded Terms” field in “Settings > Discussion”

## FAQ

### What is the source for the default blacklist?

The default blacklist is maintained by [Grant Hutchinson](https://splorp.com/) on
[GitHub](https://github.com/splorp/wordpress-comment-blacklist/).

### How often is the default blacklist updated?

Generally, the default blacklist is updated several times per month. This includes
the addition of new entries and the optimizing of existing entries. Sometimes the
default blacklist can undergo multiple updates per week, depending on how much spam
in being sent to public WordPress sites we use to test the plugin.

### Can I provide my own blacklist sources?

Yes, you can. Use the filter `cblm_sources` to add different source URLs.

**To replace the default source completely:**

    ```
    add_filter( 'cblm_sources', 'rkv_cblm_replace_blacklist_sources' );

    function rkv_cblm_replace_blacklist_sources( $list ) {

        return array(
            'http://example.com/blacklist-1.txt'
            'http://example.com/blacklist-2.txt'
        );

    }
    ```

**To add a new source to the existing sources:**

    ```
    add_filter( 'cblm_sources', 'rkv_cblm_add_blacklist_source' );

    function rkv_cblm_add_blacklist_source( $list ) {

        $list[] = 'http://example.com/blacklist-1.txt';

        return $list;

    }
    ```

The plugin expects the list of terms to be in plain text format with each entry 
on its own line. If the source is provided in a different format (eg: a JSON feed
or serialized array), then the result must be run through the `cblm_parse_data_result`
filter, which parses the source as a list of terms and the source URL.

### What is the default update schedule?

The plugin will update the list of terms from the specified sources every 24 hours.

### Can I change the update schedule?

Yes, you can. Use the filter `cblm_update_schedule` to modify the time between updates.

    ```
    add_filter( 'cblm_update_schedule', 'rkv_cblm_custom_schedule' );

    function rkv_cblm_custom_schedule( $time ) {

        return DAY_IN_SECONDS;

    }
    ```

The `return` data should be specified using WordPress [Transient Time Constants](https://codex.wordpress.org/Transients_API#Using_Time_Constants).

### Can I add my own terms to the blacklist?

Yes. Individual terms can be added to the “Local Blacklist” field in the “Settings
> Discussion” area of WordPress. Each term must be entered on its own line.

### Can I exclude terms from the blacklist?

Yes. Individual terms can be excluded from the automatically fetched blacklist by
adding them to the “Excluded Terms” field in the “Settings > Discussion” area of
WordPress. Each term must be entered on its own line.

## Reviews

![](https://secure.gravatar.com/avatar/04f0b4e5631a83cbcbccf0e952552fd44072bacd6334155e356464292c30e68a?
s=60&d=retro&r=g)

### 󠀁[Great Little Plugin](https://wordpress.org/support/topic/great-little-plugin-90/)󠁿

 [Jake Jackson](https://profiles.wordpress.org/blue-liquid-designs/) ସେପ୍ଟେମ୍ବର 
3, 2016

Does as advertised. I especially liked how you can exclude words from the automated
blacklist if they don’t suit your website.

 [ Read all 5 reviews ](https://wordpress.org/support/plugin/comment-blacklist-manager/reviews/)

## Contributors & Developers

“Comment Blacklist Manager” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Andrew Norcross ](https://profiles.wordpress.org/norcross/)
 *   [ Grant Hutchinson ](https://profiles.wordpress.org/grantsplorp/)

“Comment Blacklist Manager” has been translated into 3 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/comment-blacklist-manager/contributors)
for their contributions.

[Translate “Comment Blacklist Manager” into your language.](https://translate.wordpress.org/projects/wp-plugins/comment-blacklist-manager)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/comment-blacklist-manager/),
check out the [SVN repository](https://plugins.svn.wordpress.org/comment-blacklist-manager/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/comment-blacklist-manager/)
by [RSS](https://plugins.trac.wordpress.org/log/comment-blacklist-manager/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.1 — 23-Mar-2020

 * Fixed admin notice to properly clear when a manual update is run
 * Minor code cleanup

#### 1.0.0

 * Initial release

## Meta

 *  Version **1.0.1**
 *  Last updated **2 weeks ago**
 *  Active installations **600+**
 *  WordPress version ** 5.6 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.0 or higher **
 *  Languages
 * [English (US)](https://wordpress.org/plugins/comment-blacklist-manager/), [German](https://de.wordpress.org/plugins/comment-blacklist-manager/),
   [Spanish (Chile)](https://cl.wordpress.org/plugins/comment-blacklist-manager/),
   and [Spanish (Spain)](https://es.wordpress.org/plugins/comment-blacklist-manager/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/comment-blacklist-manager)
 * Tags
 * [blacklist](https://ory.wordpress.org/plugins/tags/blacklist/)[comments](https://ory.wordpress.org/plugins/tags/comments/)
   [spam](https://ory.wordpress.org/plugins/tags/spam/)
 *  [Advanced View](https://ory.wordpress.org/plugins/comment-blacklist-manager/advanced/)

## Ratings

 4.4 out of 5 stars.

 *  [  4 5-star reviews     ](https://wordpress.org/support/plugin/comment-blacklist-manager/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/comment-blacklist-manager/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/comment-blacklist-manager/reviews/?filter=3)
 *  [  1 2-star review     ](https://wordpress.org/support/plugin/comment-blacklist-manager/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/comment-blacklist-manager/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/comment-blacklist-manager/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/comment-blacklist-manager/reviews/)

## Contributors

 *   [ Andrew Norcross ](https://profiles.wordpress.org/norcross/)
 *   [ Grant Hutchinson ](https://profiles.wordpress.org/grantsplorp/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/comment-blacklist-manager/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](http://andrewnorcross.com/donate)