Comment Blacklist Manager

FAQ

What is the source for the default blacklist?

The default blacklist is maintained by Grant Hutchinson on GitHub.

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.

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.