Clone wiki

fccv / Home

About fccv

If you're using django.contrib.comments in your Django app and having problems with spam, this app is an easy way to fight it. It provides a customizable chain of validators that can block comments based on:

  • phrase or IP blacklists
  • the number of links in the comment
  • whether other questionable (non-public) comments have been posted from the commenter's IP
  • what Akismet or TypePad AntiSpam say about the comment

It also provides some batch tools for managing comments in the Django admin interface.

Installing it

1) Download the source and unzip it or check it out with:

hg clone

2) Change directory to the top of the source tree and run python install or simply copy the fccv subdirectory to your PYTHONPATH.

3) Add 'fccv' to your Django INSTALLED_APPS setting.

4) Run ' syncdb' to create the phrase blacklist and banned IP tables, and load the starter set of blacklists.

5) By default, only local validation is performed. If you want to add Akismet or TypePad AntiSpam, you'll need to add another setting, FCCV_VALIDATORS, e.g.:


Then add your API key. For Akismet:

    AKISMET_API_KEY = "your_API_key"

For TypePad:


6) If you want to write your own validator, create a module containing a function that takes two arguments: a django.contrib.comments.models.Comment and a django.http.HttpRequest. The function should either return None if it doesn't want to make a call on the comment, or a score from 0 to 1 indicating the probability that the comment is spam. Then just add that function to FCCV_VALIDATORS.


MIT -- see LICENSE in the source tree.


The Akismet/TypePad support is essentially this:

I learned how to apply the Tanimoto coefficient from the excellent O'Reilly book "Programming Collective Intelligence", by Toby Segaran. The book's a treasure trove.