Spam comment filters

In just a few years, comment and trackback spamming has grown from scarce to massive phenomenon.

It is now more than recommended to have a set of filters capable of recognizing spam from real comments, and that's what provides the Antispam plugin.

Filter organization

To access the antispam module configuration, click on Antispam in the left column. The page is divided in three sections:


Informs you of the number of filtered and published comments, and lets you delete all spam comments in a single operation.

Available spam filters

The available filters can be activated individually and placed in the order you like. Filters are applied from top to bottom.


The Fair trackbacks filter is applied first to prevent unnecessary tests by the other filters. We recommend that you leave it on top. Also, the IP Filter is able to determine that a comment is not spam, so you should always leave it in the second position.

To reorder the filters, drag and drop them with your mouse in the desired position. To enable or disable a filter, tick or untick the corresponding checkbox. Click on Save to apply the changes.


Some default spam filters (IP Lookup, Links Lookup and Akismet) need to access the network, which can take some time. We recommend that you leave them at the end of the list.


These are links to RSS feeds that let you track spam comments and published comments.

Filter configuration

Some filters have their own configuration interface accessible via a link located on their lines in the filter list.

Fair trackbacks

This filter checks whether incoming trackbacks include a link to the post they are trackbacking. If it's not the case, the trackbacks are automatically denied access, i.e. they won't be listed in the junk comment list.

IP Filter

This filter allows you to add IP addresses to a black list or a white list manually. If a comments come from a blacklisted IP address, it will be immediately classified as spam. And if a comment comes from a "whitelisted" IP address, it will be considered as safe and the other filters won't be applied.

To add an IP address, first choose the "black list" or "white list" tab then add the address.

The "Global IP" checkbox is available is you are super administrator, and it allows you to apply this setting to all the blogs of your installation. Global IPs are displayed on a green background.


You can add IP addresses with a network mask to block a whole series of addresses. For example you may add or the abbreviated form, 127/8.

Bad Words

This one filters comments when the author's name, email address or URL, or the content of the comment, includes certain defined words.

As for the IP address filter, you simply need to add the words you want to block to the list. If you have the required permissions, you may also add global words that will trigger the filter on all blogs of your installation.


You can also add a regular expression to you word list by starting and ending words with "/". For example, "/foo/" will filter all words containing "foo".

IP Lookup

IP Lookup is a filter that checks the IP address of the comment author against shared IP lists called DNSBL (or RBL). You may add as many servers as you like, separating them with commas.

The filter uses et as default servers.

This filter works a bit like IP Lookup, except that instead of checking the author's IP address, it checks whether the links included in the comment (including the author's site) are featured on the "multi" list of This filter cannot be configured.


Akismet is a spam filter service provided by Automattic that yields excellent results. To activate it, you need an "API key" that you will enter in the Akismet API key of the filter's page.

To get this most desirable key, you need to sign up for a account. Once your account is created, you will receive a welcome email containing the key, which will also be available from your profile page.

Learn more.

Akismet and multiblog

To use the same Akismet key on all the blogs of a single installation, you should set blog_id to null for the setting_id 'ak_key' in the dc_setting table.

This will make the key available to all. If you wish to prevent other users from changing it, you can set the DC_AKISMET_SUPER constant to true in the configuration. This will block Akismet's interface to all users that are not super administrators (but enabling or disabling the filter will still be possible).

Wiki powered by Dokuwiki.